diff --git a/admin/directory/v1/admin-api.json b/admin/directory/v1/admin-api.json index d3bb54e7029..9d77dda6817 100644 --- a/admin/directory/v1/admin-api.json +++ b/admin/directory/v1/admin-api.json @@ -4643,7 +4643,7 @@ } } }, - "revision": "20230905", + "revision": "20231005", "rootUrl": "https://admin.googleapis.com/", "schemas": { "Alias": { @@ -6812,7 +6812,8 @@ "id": "OrgUnit", "properties": { "blockInheritance": { - "description": "Determines if a sub-organizational unit can inherit the settings of the parent organization. The default value is `false`, meaning a sub-organizational unit inherits the settings of the nearest parent organizational unit. We recommend using the default value because setting `block_inheritance` to `true` can have _unintended consequences_. For more information about inheritance and users in an organization structure, see the [administration help center](https://support.google.com/a/answer/4352075).", + "deprecated": true, + "description": "Determines if a sub-organizational unit can inherit the settings of the parent organization. The default value is `false`, meaning a sub-organizational unit inherits the settings of the nearest parent organizational unit. This field is deprecated. Setting it to `true` is no longer supported and can have _unintended consequences_. For more information about inheritance and users in an organization structure, see the [administration help center](https://support.google.com/a/answer/4352075).", "type": "boolean" }, "description": { diff --git a/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index 8defa19ae3e..8f82bb30bec 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -4026,11 +4026,11 @@ type OrgUnit struct { // BlockInheritance: Determines if a sub-organizational unit can inherit // the settings of the parent organization. The default value is // `false`, meaning a sub-organizational unit inherits the settings of - // the nearest parent organizational unit. We recommend using the - // default value because setting `block_inheritance` to `true` can have - // _unintended consequences_. For more information about inheritance and - // users in an organization structure, see the administration help - // center (https://support.google.com/a/answer/4352075). + // the nearest parent organizational unit. This field is deprecated. + // Setting it to `true` is no longer supported and can have _unintended + // consequences_. For more information about inheritance and users in an + // organization structure, see the administration help center + // (https://support.google.com/a/answer/4352075). BlockInheritance bool `json:"blockInheritance,omitempty"` // Description: Description of the organizational unit. diff --git a/adsense/v2/adsense-api.json b/adsense/v2/adsense-api.json index 540e51dc128..f3aecfad662 100644 --- a/adsense/v2/adsense-api.json +++ b/adsense/v2/adsense-api.json @@ -837,6 +837,72 @@ } } }, + "policyIssues": { + "methods": { + "get": { + "description": "Gets information about the selected policy issue.", + "flatPath": "v2/accounts/{accountsId}/policyIssues/{policyIssuesId}", + "httpMethod": "GET", + "id": "adsense.accounts.policyIssues.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the policy issue. Format: accounts/{account}/policyIssues/{policy_issue}", + "location": "path", + "pattern": "^accounts/[^/]+/policyIssues/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "PolicyIssue" + }, + "scopes": [ + "https://www.googleapis.com/auth/adsense" + ] + }, + "list": { + "description": "Lists all the policy issues for the specified account.", + "flatPath": "v2/accounts/{accountsId}/policyIssues", + "httpMethod": "GET", + "id": "adsense.accounts.policyIssues.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "The maximum number of policy issues to include in the response, used for paging. If unspecified, at most 10000 policy issues will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token, received from a previous `ListPolicyIssues` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPolicyIssues` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The account for which policy issues are being retrieved. Format: accounts/{account}", + "location": "path", + "pattern": "^accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/policyIssues", + "response": { + "$ref": "ListPolicyIssuesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/adsense", + "https://www.googleapis.com/auth/adsense.readonly" + ] + } + } + }, "reports": { "methods": { "generate": { @@ -1844,7 +1910,7 @@ } } }, - "revision": "20230703", + "revision": "20231011", "rootUrl": "https://adsense.googleapis.com/", "schemas": { "Account": { @@ -2391,6 +2457,24 @@ }, "type": "object" }, + "ListPolicyIssuesResponse": { + "description": "Response definition for the policy issues list rpc. Policy issues are reported only if the publisher has at least one AFC ad client in READY or GETTING_READY state. If the publisher has no such AFC ad client, the response will be an empty list.", + "id": "ListPolicyIssuesResponse", + "properties": { + "nextPageToken": { + "description": "Continuation token used to page through policy issues. To retrieve the next page of the results, set the next request's \"page_token\" value to this.", + "type": "string" + }, + "policyIssues": { + "description": "The policy issues returned in the list response.", + "items": { + "$ref": "PolicyIssue" + }, + "type": "array" + } + }, + "type": "object" + }, "ListSavedReportsResponse": { "description": "Response definition for the saved reports list rpc.", "id": "ListSavedReportsResponse", @@ -2467,6 +2551,109 @@ }, "type": "object" }, + "PolicyIssue": { + "description": "Representation of a policy issue for a single entity (site, site-section, or page). All issues for a single entity are represented by a single PolicyIssue resource, though that PolicyIssue can have multiple causes (or \"topics\") that can change over time. Policy issues are removed if there are no issues detected recently or if there's a recent successful appeal for the entity.", + "id": "PolicyIssue", + "properties": { + "action": { + "description": "Required. The most severe action taken on the entity over the past seven days.", + "enum": [ + "ENFORCEMENT_ACTION_UNSPECIFIED", + "WARNED", + "AD_SERVING_RESTRICTED", + "AD_SERVING_DISABLED", + "AD_SERVED_WITH_CLICK_CONFIRMATION" + ], + "enumDescriptions": [ + "The action is unspecified.", + "No ad serving enforcement is currently present, but enforcement will start on the `warning_escalation_date` if the issue is not resolved.", + "Ad serving demand has been restricted on the entity.", + "Ad serving has been disabled on the entity.", + "Ads are being served for the entity but Confirmed Click is being applied to the ads. See https://support.google.com/adsense/answer/10025624." + ], + "type": "string" + }, + "adClients": { + "description": "Optional. List of ad clients associated with the policy issue (either as the primary ad client or an associated host/secondary ad client). In the latter case, this will be an ad client that is not owned by the current account.", + "items": { + "type": "string" + }, + "type": "array" + }, + "adRequestCount": { + "description": "Required. Total number of ad requests affected by the policy violations over the past seven days.", + "format": "int64", + "type": "string" + }, + "entityType": { + "description": "Required. Type of the entity indicating if the entity is a site, site-section, or page.", + "enum": [ + "ENTITY_TYPE_UNSPECIFIED", + "SITE", + "SITE_SECTION", + "PAGE" + ], + "enumDescriptions": [ + "The entity type is unspecified.", + "The enforced entity is an entire website.", + "The enforced entity is a particular section of a website. All the pages with this prefix are enforced.", + "The enforced entity is a single web page." + ], + "type": "string" + }, + "firstDetectedDate": { + "$ref": "Date", + "description": "Required. The date (in the America/Los_Angeles timezone) when policy violations were first detected on the entity." + }, + "lastDetectedDate": { + "$ref": "Date", + "description": "Required. The date (in the America/Los_Angeles timezone) when policy violations were last detected on the entity." + }, + "name": { + "description": "Required. Resource name of the entity with policy issues. Format: accounts/{account}/policyIssues/{policy_issue}", + "type": "string" + }, + "policyTopics": { + "description": "Required. Unordered list. The policy topics that this entity was found to violate over the past seven days.", + "items": { + "$ref": "PolicyTopic" + }, + "type": "array" + }, + "site": { + "description": "Required. Hostname/domain of the entity (for example \"foo.com\" or \"www.foo.com\"). This _should_ be a bare domain/host name without any protocol. This will be present for all policy issues.", + "type": "string" + }, + "siteSection": { + "description": "Optional. Prefix of the site-section having policy issues (For example \"foo.com/bar-section\"). This will be present if the `entity_type` is `SITE_SECTION` and will be absent for other entity types.", + "type": "string" + }, + "uri": { + "description": "Optional. URI of the page having policy violations (for example \"foo.com/bar\" or \"www.foo.com/bar\"). This will be present if the `entity_type` is `PAGE` and will be absent for other entity types.", + "type": "string" + }, + "warningEscalationDate": { + "$ref": "Date", + "description": "Optional. The date (in the America/Los_Angeles timezone) when the entity will have ad serving demand restricted or ad serving disabled. This is present only for issues with a `WARNED` enforcement action. See https://support.google.com/adsense/answer/11066888." + } + }, + "type": "object" + }, + "PolicyTopic": { + "description": "Information about a particular policy topic. A policy topic represents a single class of policy issue that can impact ad serving for your site. For example, sexual content or having ads that obscure your content. A single policy issue can have multiple policy topics for a single entity.", + "id": "PolicyTopic", + "properties": { + "mustFix": { + "description": "Required. Indicates if this is a policy violation or not. When the value is true, issues that are instances of this topic must be addressed to remain in compliance with the partner's agreements with Google. A false value indicates that it's not mandatory to fix the issues but advertising demand might be restricted.", + "type": "boolean" + }, + "topic": { + "description": "Required. The policy topic. For example, \"sexual-content\" or \"ads-obscuring-content\".\"", + "type": "string" + } + }, + "type": "object" + }, "ReportResult": { "description": "Result of a generated report.", "id": "ReportResult", diff --git a/adsense/v2/adsense-gen.go b/adsense/v2/adsense-gen.go index e7bc3518ede..5df9149ef82 100644 --- a/adsense/v2/adsense-gen.go +++ b/adsense/v2/adsense-gen.go @@ -164,6 +164,7 @@ func NewAccountsService(s *Service) *AccountsService { rs.Adclients = NewAccountsAdclientsService(s) rs.Alerts = NewAccountsAlertsService(s) rs.Payments = NewAccountsPaymentsService(s) + rs.PolicyIssues = NewAccountsPolicyIssuesService(s) rs.Reports = NewAccountsReportsService(s) rs.Sites = NewAccountsSitesService(s) return rs @@ -178,6 +179,8 @@ type AccountsService struct { Payments *AccountsPaymentsService + PolicyIssues *AccountsPolicyIssuesService + Reports *AccountsReportsService Sites *AccountsSitesService @@ -246,6 +249,15 @@ type AccountsPaymentsService struct { s *Service } +func NewAccountsPolicyIssuesService(s *Service) *AccountsPolicyIssuesService { + rs := &AccountsPolicyIssuesService{s: s} + return rs +} + +type AccountsPolicyIssuesService struct { + s *Service +} + func NewAccountsReportsService(s *Service) *AccountsReportsService { rs := &AccountsReportsService{s: s} rs.Saved = NewAccountsReportsSavedService(s) @@ -1226,6 +1238,47 @@ func (s *ListPaymentsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListPolicyIssuesResponse: Response definition for the policy issues +// list rpc. Policy issues are reported only if the publisher has at +// least one AFC ad client in READY or GETTING_READY state. If the +// publisher has no such AFC ad client, the response will be an empty +// list. +type ListPolicyIssuesResponse struct { + // NextPageToken: Continuation token used to page through policy issues. + // To retrieve the next page of the results, set the next request's + // "page_token" value to this. + NextPageToken string `json:"nextPageToken,omitempty"` + + // PolicyIssues: The policy issues returned in the list response. + PolicyIssues []*PolicyIssue `json:"policyIssues,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListPolicyIssuesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListPolicyIssuesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListSavedReportsResponse: Response definition for the saved reports // list rpc. type ListSavedReportsResponse struct { @@ -1388,6 +1441,156 @@ func (s *Payment) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// PolicyIssue: Representation of a policy issue for a single entity +// (site, site-section, or page). All issues for a single entity are +// represented by a single PolicyIssue resource, though that PolicyIssue +// can have multiple causes (or "topics") that can change over time. +// Policy issues are removed if there are no issues detected recently or +// if there's a recent successful appeal for the entity. +type PolicyIssue struct { + // Action: Required. The most severe action taken on the entity over the + // past seven days. + // + // Possible values: + // "ENFORCEMENT_ACTION_UNSPECIFIED" - The action is unspecified. + // "WARNED" - No ad serving enforcement is currently present, but + // enforcement will start on the `warning_escalation_date` if the issue + // is not resolved. + // "AD_SERVING_RESTRICTED" - Ad serving demand has been restricted on + // the entity. + // "AD_SERVING_DISABLED" - Ad serving has been disabled on the entity. + // "AD_SERVED_WITH_CLICK_CONFIRMATION" - Ads are being served for the + // entity but Confirmed Click is being applied to the ads. See + // https://support.google.com/adsense/answer/10025624. + Action string `json:"action,omitempty"` + + // AdClients: Optional. List of ad clients associated with the policy + // issue (either as the primary ad client or an associated + // host/secondary ad client). In the latter case, this will be an ad + // client that is not owned by the current account. + AdClients []string `json:"adClients,omitempty"` + + // AdRequestCount: Required. Total number of ad requests affected by the + // policy violations over the past seven days. + AdRequestCount int64 `json:"adRequestCount,omitempty,string"` + + // EntityType: Required. Type of the entity indicating if the entity is + // a site, site-section, or page. + // + // Possible values: + // "ENTITY_TYPE_UNSPECIFIED" - The entity type is unspecified. + // "SITE" - The enforced entity is an entire website. + // "SITE_SECTION" - The enforced entity is a particular section of a + // website. All the pages with this prefix are enforced. + // "PAGE" - The enforced entity is a single web page. + EntityType string `json:"entityType,omitempty"` + + // FirstDetectedDate: Required. The date (in the America/Los_Angeles + // timezone) when policy violations were first detected on the entity. + FirstDetectedDate *Date `json:"firstDetectedDate,omitempty"` + + // LastDetectedDate: Required. The date (in the America/Los_Angeles + // timezone) when policy violations were last detected on the entity. + LastDetectedDate *Date `json:"lastDetectedDate,omitempty"` + + // Name: Required. Resource name of the entity with policy issues. + // Format: accounts/{account}/policyIssues/{policy_issue} + Name string `json:"name,omitempty"` + + // PolicyTopics: Required. Unordered list. The policy topics that this + // entity was found to violate over the past seven days. + PolicyTopics []*PolicyTopic `json:"policyTopics,omitempty"` + + // Site: Required. Hostname/domain of the entity (for example "foo.com" + // or "www.foo.com"). This _should_ be a bare domain/host name without + // any protocol. This will be present for all policy issues. + Site string `json:"site,omitempty"` + + // SiteSection: Optional. Prefix of the site-section having policy + // issues (For example "foo.com/bar-section"). This will be present if + // the `entity_type` is `SITE_SECTION` and will be absent for other + // entity types. + SiteSection string `json:"siteSection,omitempty"` + + // Uri: Optional. URI of the page having policy violations (for example + // "foo.com/bar" or "www.foo.com/bar"). This will be present if the + // `entity_type` is `PAGE` and will be absent for other entity types. + Uri string `json:"uri,omitempty"` + + // WarningEscalationDate: Optional. The date (in the America/Los_Angeles + // timezone) when the entity will have ad serving demand restricted or + // ad serving disabled. This is present only for issues with a `WARNED` + // enforcement action. See + // https://support.google.com/adsense/answer/11066888. + WarningEscalationDate *Date `json:"warningEscalationDate,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Action") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Action") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PolicyIssue) MarshalJSON() ([]byte, error) { + type NoMethod PolicyIssue + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// PolicyTopic: Information about a particular policy topic. A policy +// topic represents a single class of policy issue that can impact ad +// serving for your site. For example, sexual content or having ads that +// obscure your content. A single policy issue can have multiple policy +// topics for a single entity. +type PolicyTopic struct { + // MustFix: Required. Indicates if this is a policy violation or not. + // When the value is true, issues that are instances of this topic must + // be addressed to remain in compliance with the partner's agreements + // with Google. A false value indicates that it's not mandatory to fix + // the issues but advertising demand might be restricted. + MustFix bool `json:"mustFix,omitempty"` + + // Topic: Required. The policy topic. For example, "sexual-content" or + // "ads-obscuring-content"." + Topic string `json:"topic,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MustFix") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MustFix") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PolicyTopic) MarshalJSON() ([]byte, error) { + type NoMethod PolicyTopic + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ReportResult: Result of a generated report. type ReportResult struct { // Averages: The averages of the report. This is the same length as any @@ -5489,6 +5692,352 @@ func (c *AccountsPaymentsListCall) Do(opts ...googleapi.CallOption) (*ListPaymen } +// method id "adsense.accounts.policyIssues.get": + +type AccountsPolicyIssuesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about the selected policy issue. +// +// - name: Name of the policy issue. Format: +// accounts/{account}/policyIssues/{policy_issue}. +func (r *AccountsPolicyIssuesService) Get(name string) *AccountsPolicyIssuesGetCall { + c := &AccountsPolicyIssuesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *AccountsPolicyIssuesGetCall) Fields(s ...googleapi.Field) *AccountsPolicyIssuesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *AccountsPolicyIssuesGetCall) IfNoneMatch(entityTag string) *AccountsPolicyIssuesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *AccountsPolicyIssuesGetCall) Context(ctx context.Context) *AccountsPolicyIssuesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *AccountsPolicyIssuesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsPolicyIssuesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "adsense.accounts.policyIssues.get" call. +// Exactly one of *PolicyIssue or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *PolicyIssue.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountsPolicyIssuesGetCall) Do(opts ...googleapi.CallOption) (*PolicyIssue, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &PolicyIssue{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets information about the selected policy issue.", + // "flatPath": "v2/accounts/{accountsId}/policyIssues/{policyIssuesId}", + // "httpMethod": "GET", + // "id": "adsense.accounts.policyIssues.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Name of the policy issue. Format: accounts/{account}/policyIssues/{policy_issue}", + // "location": "path", + // "pattern": "^accounts/[^/]+/policyIssues/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+name}", + // "response": { + // "$ref": "PolicyIssue" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/adsense" + // ] + // } + +} + +// method id "adsense.accounts.policyIssues.list": + +type AccountsPolicyIssuesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all the policy issues for the specified account. +// +// - parent: The account for which policy issues are being retrieved. +// Format: accounts/{account}. +func (r *AccountsPolicyIssuesService) List(parent string) *AccountsPolicyIssuesListCall { + c := &AccountsPolicyIssuesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of policy issues to include in the response, used for paging. If +// unspecified, at most 10000 policy issues will be returned. The +// maximum value is 10000; values above 10000 will be coerced to 10000. +func (c *AccountsPolicyIssuesListCall) PageSize(pageSize int64) *AccountsPolicyIssuesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListPolicyIssues` call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters +// provided to `ListPolicyIssues` must match the call that provided the +// page token. +func (c *AccountsPolicyIssuesListCall) PageToken(pageToken string) *AccountsPolicyIssuesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *AccountsPolicyIssuesListCall) Fields(s ...googleapi.Field) *AccountsPolicyIssuesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *AccountsPolicyIssuesListCall) IfNoneMatch(entityTag string) *AccountsPolicyIssuesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *AccountsPolicyIssuesListCall) Context(ctx context.Context) *AccountsPolicyIssuesListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *AccountsPolicyIssuesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsPolicyIssuesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/policyIssues") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "adsense.accounts.policyIssues.list" call. +// Exactly one of *ListPolicyIssuesResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListPolicyIssuesResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *AccountsPolicyIssuesListCall) Do(opts ...googleapi.CallOption) (*ListPolicyIssuesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListPolicyIssuesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists all the policy issues for the specified account.", + // "flatPath": "v2/accounts/{accountsId}/policyIssues", + // "httpMethod": "GET", + // "id": "adsense.accounts.policyIssues.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "The maximum number of policy issues to include in the response, used for paging. If unspecified, at most 10000 policy issues will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token, received from a previous `ListPolicyIssues` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPolicyIssues` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The account for which policy issues are being retrieved. Format: accounts/{account}", + // "location": "path", + // "pattern": "^accounts/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/policyIssues", + // "response": { + // "$ref": "ListPolicyIssuesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/adsense", + // "https://www.googleapis.com/auth/adsense.readonly" + // ] + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountsPolicyIssuesListCall) Pages(ctx context.Context, f func(*ListPolicyIssuesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + // method id "adsense.accounts.reports.generate": type AccountsReportsGenerateCall struct { diff --git a/cloudtasks/v2/cloudtasks-api.json b/cloudtasks/v2/cloudtasks-api.json index 0d1ec55ae35..fa0ce0578f9 100644 --- a/cloudtasks/v2/cloudtasks-api.json +++ b/cloudtasks/v2/cloudtasks-api.json @@ -134,6 +134,31 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getCmekConfig": { + "description": "Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/cmekConfig", + "httpMethod": "GET", + "id": "cloudtasks.projects.locations.getCmekConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The config. For example: projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "CmekConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "list": { "description": "Lists information about the supported locations for this service.", "flatPath": "v2/projects/{projectsId}/locations", @@ -174,6 +199,40 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "updateCmekConfig": { + "description": "Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key assotiated with the Cloud Tasks location (Creates if the key does not already exist). All new tasks created in the location will be encrypted at-rest with the KMS-key provided in the config.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/cmekConfig", + "httpMethod": "PATCH", + "id": "cloudtasks.projects.locations.updateCmekConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "List of fields to be updated in this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "CmekConfig" + }, + "response": { + "$ref": "CmekConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -685,7 +744,7 @@ } } }, - "revision": "20230906", + "revision": "20230929", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpRequest": { @@ -810,6 +869,22 @@ }, "type": "object" }, + "CmekConfig": { + "description": "CMEK, or Customer Managed Encryption Keys, enables GCP products to put control over encryption and key management in their customer’s hands.", + "id": "CmekConfig", + "properties": { + "kmsKey": { + "description": "Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues \u0026 Tasks in the region. Setting this as blank will turn off CMEK encryption.", + "type": "string" + }, + "name": { + "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "CreateTaskRequest": { "description": "Request message for CreateTask.", "id": "CreateTaskRequest", diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index e55fcc93ecb..f290a50589d 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -530,6 +530,48 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// CmekConfig: CMEK, or Customer Managed Encryption Keys, enables GCP +// products to put control over encryption and key management in their +// customer’s hands. +type CmekConfig struct { + // KmsKey: Resource name of the Cloud KMS key, of the form + // `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/crypto + // Keys/KEY_ID`, that will be used to encrypt the Queues & Tasks in the + // region. Setting this as blank will turn off CMEK encryption. + KmsKey string `json:"kmsKey,omitempty"` + + // Name: Output only. The config resource name which includes the + // project and location and must end in 'cmekConfig', in the format + // projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig` + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "KmsKey") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "KmsKey") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *CmekConfig) MarshalJSON() ([]byte, error) { + type NoMethod CmekConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // CreateTaskRequest: Request message for CreateTask. type CreateTaskRequest struct { // ResponseView: The response_view specifies which subset of the Task @@ -2016,6 +2058,155 @@ func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, } +// method id "cloudtasks.projects.locations.getCmekConfig": + +type ProjectsLocationsGetCmekConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetCmekConfig: Gets the CMEK config. Gets the Customer Managed +// Encryption Key configured with the Cloud Tasks lcoation. By default +// there is no kms_key configured. +// +// - name: The config. For example: +// projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig`. +func (r *ProjectsLocationsService) GetCmekConfig(name string) *ProjectsLocationsGetCmekConfigCall { + c := &ProjectsLocationsGetCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsGetCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCmekConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsGetCmekConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCmekConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGetCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsGetCmekConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGetCmekConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCmekConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudtasks.projects.locations.getCmekConfig" call. +// Exactly one of *CmekConfig or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *CmekConfig.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (*CmekConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &CmekConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/cmekConfig", + // "httpMethod": "GET", + // "id": "cloudtasks.projects.locations.getCmekConfig", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The config. For example: projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+name}", + // "response": { + // "$ref": "CmekConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "cloudtasks.projects.locations.list": type ProjectsLocationsListCall struct { @@ -2225,6 +2416,167 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } +// method id "cloudtasks.projects.locations.updateCmekConfig": + +type ProjectsLocationsUpdateCmekConfigCall struct { + s *Service + name string + cmekconfig *CmekConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateCmekConfig: Creates or Updates a CMEK config. Updates the +// Customer Managed Encryption Key assotiated with the Cloud Tasks +// location (Creates if the key does not already exist). All new tasks +// created in the location will be encrypted at-rest with the KMS-key +// provided in the config. +// +// - name: Output only. The config resource name which includes the +// project and location and must end in 'cmekConfig', in the format +// projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`. +func (r *ProjectsLocationsService) UpdateCmekConfig(name string, cmekconfig *CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { + c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.cmekconfig = cmekconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": List of fields +// to be updated in this request. +func (c *ProjectsLocationsUpdateCmekConfigCall) UpdateMask(updateMask string) *ProjectsLocationsUpdateCmekConfigCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsUpdateCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateCmekConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsUpdateCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateCmekConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsUpdateCmekConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.cmekconfig) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudtasks.projects.locations.updateCmekConfig" call. +// Exactly one of *CmekConfig or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *CmekConfig.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) (*CmekConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &CmekConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key assotiated with the Cloud Tasks location (Creates if the key does not already exist). All new tasks created in the location will be encrypted at-rest with the KMS-key provided in the config.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/cmekConfig", + // "httpMethod": "PATCH", + // "id": "cloudtasks.projects.locations.updateCmekConfig", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "List of fields to be updated in this request.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v2/{+name}", + // "request": { + // "$ref": "CmekConfig" + // }, + // "response": { + // "$ref": "CmekConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "cloudtasks.projects.locations.queues.create": type ProjectsLocationsQueuesCreateCall struct { diff --git a/cloudtasks/v2beta2/cloudtasks-api.json b/cloudtasks/v2beta2/cloudtasks-api.json index 250c04536ba..2b5cdc51d30 100644 --- a/cloudtasks/v2beta2/cloudtasks-api.json +++ b/cloudtasks/v2beta2/cloudtasks-api.json @@ -238,17 +238,13 @@ "httpMethod": "PATCH", "id": "cloudtasks.projects.locations.updateCmekConfig", "parameterOrder": [ - "projectsId", - "locationsId" + "name" ], "parameters": { - "locationsId": { - "location": "path", - "required": true, - "type": "string" - }, - "projectsId": { + "name": { + "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", "required": true, "type": "string" }, @@ -259,7 +255,7 @@ "type": "string" } }, - "path": "v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig", + "path": "v2beta2/{+name}", "request": { "$ref": "CmekConfig" }, @@ -939,7 +935,7 @@ } } }, - "revision": "20230906", + "revision": "20230929", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AcknowledgeTaskRequest": { diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 42677efc6c2..da7abe8b282 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -3382,13 +3382,12 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat // method id "cloudtasks.projects.locations.updateCmekConfig": type ProjectsLocationsUpdateCmekConfigCall struct { - s *Service - projectsId string - locationsId string - cmekconfig *CmekConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header + s *Service + name string + cmekconfig *CmekConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } // UpdateCmekConfig: Creates or Updates a CMEK config. Updates the @@ -3397,12 +3396,12 @@ type ProjectsLocationsUpdateCmekConfigCall struct { // created in the location will be encrypted at-rest with the KMS-key // provided in the config. // -// - locationsId: . -// - projectsId: . -func (r *ProjectsLocationsService) UpdateCmekConfig(projectsId string, locationsId string, cmekconfig *CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { +// - name: Output only. The config resource name which includes the +// project and location and must end in 'cmekConfig', in the format +// projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`. +func (r *ProjectsLocationsService) UpdateCmekConfig(name string, cmekconfig *CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.projectsId = projectsId - c.locationsId = locationsId + c.name = name c.cmekconfig = cmekconfig return c } @@ -3454,7 +3453,7 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Res reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta2/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("PATCH", urls, body) if err != nil { @@ -3462,8 +3461,7 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Res } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "projectsId": c.projectsId, - "locationsId": c.locationsId, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } @@ -3511,17 +3509,13 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) // "httpMethod": "PATCH", // "id": "cloudtasks.projects.locations.updateCmekConfig", // "parameterOrder": [ - // "projectsId", - // "locationsId" + // "name" // ], // "parameters": { - // "locationsId": { - // "location": "path", - // "required": true, - // "type": "string" - // }, - // "projectsId": { + // "name": { + // "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", // "required": true, // "type": "string" // }, @@ -3532,7 +3526,7 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) // "type": "string" // } // }, - // "path": "v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig", + // "path": "v2beta2/{+name}", // "request": { // "$ref": "CmekConfig" // }, diff --git a/cloudtasks/v2beta3/cloudtasks-api.json b/cloudtasks/v2beta3/cloudtasks-api.json index 17d6d317d82..b5c3067230e 100644 --- a/cloudtasks/v2beta3/cloudtasks-api.json +++ b/cloudtasks/v2beta3/cloudtasks-api.json @@ -206,17 +206,13 @@ "httpMethod": "PATCH", "id": "cloudtasks.projects.locations.updateCmekConfig", "parameterOrder": [ - "projectsId", - "locationsId" + "name" ], "parameters": { - "locationsId": { - "location": "path", - "required": true, - "type": "string" - }, - "projectsId": { + "name": { + "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", "required": true, "type": "string" }, @@ -227,7 +223,7 @@ "type": "string" } }, - "path": "v2beta3/projects/{projectsId}/locations/{locationsId}/cmekConfig", + "path": "v2beta3/{+name}", "request": { "$ref": "CmekConfig" }, @@ -795,7 +791,7 @@ } } }, - "revision": "20230927", + "revision": "20230929", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpQueue": { diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 0fd6cb49be7..7a8dade4af5 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -3012,13 +3012,12 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat // method id "cloudtasks.projects.locations.updateCmekConfig": type ProjectsLocationsUpdateCmekConfigCall struct { - s *Service - projectsId string - locationsId string - cmekconfig *CmekConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header + s *Service + name string + cmekconfig *CmekConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } // UpdateCmekConfig: Creates or Updates a CMEK config. Updates the @@ -3027,12 +3026,12 @@ type ProjectsLocationsUpdateCmekConfigCall struct { // created in the location will be encrypted at-rest with the KMS-key // provided in the config. // -// - locationsId: . -// - projectsId: . -func (r *ProjectsLocationsService) UpdateCmekConfig(projectsId string, locationsId string, cmekconfig *CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { +// - name: Output only. The config resource name which includes the +// project and location and must end in 'cmekConfig', in the format +// projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`. +func (r *ProjectsLocationsService) UpdateCmekConfig(name string, cmekconfig *CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.projectsId = projectsId - c.locationsId = locationsId + c.name = name c.cmekconfig = cmekconfig return c } @@ -3084,7 +3083,7 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Res reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta3/projects/{projectsId}/locations/{locationsId}/cmekConfig") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta3/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("PATCH", urls, body) if err != nil { @@ -3092,8 +3091,7 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Res } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "projectsId": c.projectsId, - "locationsId": c.locationsId, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } @@ -3141,17 +3139,13 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) // "httpMethod": "PATCH", // "id": "cloudtasks.projects.locations.updateCmekConfig", // "parameterOrder": [ - // "projectsId", - // "locationsId" + // "name" // ], // "parameters": { - // "locationsId": { - // "location": "path", - // "required": true, - // "type": "string" - // }, - // "projectsId": { + // "name": { + // "description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`", // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$", // "required": true, // "type": "string" // }, @@ -3162,7 +3156,7 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) // "type": "string" // } // }, - // "path": "v2beta3/projects/{projectsId}/locations/{locationsId}/cmekConfig", + // "path": "v2beta3/{+name}", // "request": { // "$ref": "CmekConfig" // }, diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index d8434d2adb5..d95fd9874be 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -13668,6 +13668,56 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "patch": { + "description": "Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "PATCH", + "id": "compute.networkAttachments.patch", + "parameterOrder": [ + "project", + "region", + "networkAttachment" + ], + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "request": { + "$ref": "NetworkAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", @@ -34780,7 +34830,7 @@ } } }, - "revision": "20230923", + "revision": "20231003", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -53746,6 +53796,10 @@ "$ref": "ManagedInstanceLastAttempt", "description": "[Output Only] Information about the last attempt to create or delete the instance." }, + "name": { + "description": "[Output Only] The name of the instance. The name always exists even if the instance has not yet been created.", + "type": "string" + }, "preservedStateFromConfig": { "$ref": "PreservedState", "description": "[Output Only] Preserved state applied from per-instance config for this instance." @@ -54392,6 +54446,10 @@ "description": "The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless.", "type": "string" }, + "ipv6Address": { + "description": "The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6.", + "type": "string" + }, "projectIdOrNum": { "description": "The project id or number of the interface to which the IP was assigned.", "type": "string" @@ -54426,6 +54484,10 @@ "subnetwork": { "description": "The subnetwork used to assign the IP to the producer instance network interface.", "type": "string" + }, + "subnetworkCidrRange": { + "description": "[Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from.", + "type": "string" } }, "type": "object" diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index d1dd57c7602..cb3c038b027 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -28648,6 +28648,10 @@ type ManagedInstance struct { // create or delete the instance. LastAttempt *ManagedInstanceLastAttempt `json:"lastAttempt,omitempty"` + // Name: [Output Only] The name of the instance. The name always exists + // even if the instance has not yet been created. + Name string `json:"name,omitempty"` + // PreservedStateFromConfig: [Output Only] Preserved state applied from // per-instance config for this instance. PreservedStateFromConfig *PreservedState `json:"preservedStateFromConfig,omitempty"` @@ -29642,6 +29646,11 @@ type NetworkAttachmentConnectedEndpoint struct { // interface. This value will be a range in case of Serverless. IpAddress string `json:"ipAddress,omitempty"` + // Ipv6Address: The IPv6 address assigned to the producer instance + // network interface. This is only assigned when the stack types of both + // the instance network interface and the consumer subnet are IPv4_IPv6. + Ipv6Address string `json:"ipv6Address,omitempty"` + // ProjectIdOrNum: The project id or number of the interface to which // the IP was assigned. ProjectIdOrNum string `json:"projectIdOrNum,omitempty"` @@ -29669,6 +29678,10 @@ type NetworkAttachmentConnectedEndpoint struct { // instance network interface. Subnetwork string `json:"subnetwork,omitempty"` + // SubnetworkCidrRange: [Output Only] The CIDR range of the subnet from + // which the IPv4 internal IP was allocated from. + SubnetworkCidrRange string `json:"subnetworkCidrRange,omitempty"` + // ForceSendFields is a list of field names (e.g. "IpAddress") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -120154,6 +120167,197 @@ func (c *NetworkAttachmentsListCall) Pages(ctx context.Context, f func(*NetworkA } } +// method id "compute.networkAttachments.patch": + +type NetworkAttachmentsPatchCall struct { + s *Service + project string + region string + networkAttachment string + networkattachment *NetworkAttachment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Patches the specified NetworkAttachment resource with the data +// included in the request. This method supports PATCH semantics and +// uses JSON merge patch format and processing rules. +// +// - networkAttachment: Name of the NetworkAttachment resource to patch. +// - project: Project ID for this request. +// - region: Name of the region for this request. +func (r *NetworkAttachmentsService) Patch(project string, region string, networkAttachment string, networkattachment *NetworkAttachment) *NetworkAttachmentsPatchCall { + c := &NetworkAttachmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.networkAttachment = networkAttachment + c.networkattachment = networkattachment + return c +} + +// RequestId sets the optional parameter "requestId": An optional +// request ID to identify requests. Specify a unique request ID so that +// if you must retry your request, the server will know to ignore the +// request if it has already been completed. For example, consider a +// situation where you make an initial request and the request times +// out. If you make the request again with the same request ID, the +// server can check if original operation with the same request ID was +// received, and if so, will ignore the second request. This prevents +// clients from accidentally creating duplicate commitments. The request +// ID must be a valid UUID with the exception that zero UUID is not +// supported ( 00000000-0000-0000-0000-000000000000). end_interface: +// MixerMutationRequestBuilder +func (c *NetworkAttachmentsPatchCall) RequestId(requestId string) *NetworkAttachmentsPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *NetworkAttachmentsPatchCall) Fields(s ...googleapi.Field) *NetworkAttachmentsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *NetworkAttachmentsPatchCall) Context(ctx context.Context) *NetworkAttachmentsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *NetworkAttachmentsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *NetworkAttachmentsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.networkattachment) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "networkAttachment": c.networkAttachment, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.networkAttachments.patch" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *NetworkAttachmentsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.", + // "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + // "httpMethod": "PATCH", + // "id": "compute.networkAttachments.patch", + // "parameterOrder": [ + // "project", + // "region", + // "networkAttachment" + // ], + // "parameters": { + // "networkAttachment": { + // "description": "Name of the NetworkAttachment resource to patch.", + // "location": "path", + // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + // "required": true, + // "type": "string" + // }, + // "project": { + // "description": "Project ID for this request.", + // "location": "path", + // "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + // "required": true, + // "type": "string" + // }, + // "region": { + // "description": "Name of the region for this request.", + // "location": "path", + // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + // "required": true, + // "type": "string" + // }, + // "requestId": { + // "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + // "request": { + // "$ref": "NetworkAttachment" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/compute" + // ] + // } + +} + // method id "compute.networkAttachments.setIamPolicy": type NetworkAttachmentsSetIamPolicyCall struct { diff --git a/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index 171cdda34c2..fc944bca0d6 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -755,7 +755,7 @@ } } }, - "revision": "20230929", + "revision": "20231006", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -2913,6 +2913,20 @@ "object": { "description": "Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.", "type": "string" + }, + "sourceFetcher": { + "description": "Optional. Option to specify the tool to fetch the source file for the build.", + "enum": [ + "SOURCE_FETCHER_UNSPECIFIED", + "GSUTIL", + "GCS_FETCHER" + ], + "enumDescriptions": [ + "Unspecified defaults to GSUTIL.", + "Use the \"gsutil\" tool to download the source file.", + "Use the Cloud Storage Fetcher tool to download the source file." + ], + "type": "string" } }, "type": "object" diff --git a/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index 604efdd8cbd..446034dbfda 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -3157,6 +3157,16 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1StorageSource struct { // source to build. Object string `json:"object,omitempty"` + // SourceFetcher: Optional. Option to specify the tool to fetch the + // source file for the build. + // + // Possible values: + // "SOURCE_FETCHER_UNSPECIFIED" - Unspecified defaults to GSUTIL. + // "GSUTIL" - Use the "gsutil" tool to download the source file. + // "GCS_FETCHER" - Use the Cloud Storage Fetcher tool to download the + // source file. + SourceFetcher string `json:"sourceFetcher,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bucket") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index a34ab10c796..4b2d3bcc380 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -1233,7 +1233,7 @@ } } }, - "revision": "20230929", + "revision": "20231006", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -3202,6 +3202,20 @@ "object": { "description": "Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.", "type": "string" + }, + "sourceFetcher": { + "description": "Optional. Option to specify the tool to fetch the source file for the build.", + "enum": [ + "SOURCE_FETCHER_UNSPECIFIED", + "GSUTIL", + "GCS_FETCHER" + ], + "enumDescriptions": [ + "Unspecified defaults to GSUTIL.", + "Use the \"gsutil\" tool to download the source file.", + "Use the Cloud Storage Fetcher tool to download the source file." + ], + "type": "string" } }, "type": "object" diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index 87591516747..359ad483eee 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -3032,6 +3032,16 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1StorageSource struct { // source to build. Object string `json:"object,omitempty"` + // SourceFetcher: Optional. Option to specify the tool to fetch the + // source file for the build. + // + // Possible values: + // "SOURCE_FETCHER_UNSPECIFIED" - Unspecified defaults to GSUTIL. + // "GSUTIL" - Use the "gsutil" tool to download the source file. + // "GCS_FETCHER" - Use the Cloud Storage Fetcher tool to download the + // source file. + SourceFetcher string `json:"sourceFetcher,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bucket") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index 11890b17c93..4702b47c29b 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -815,7 +815,7 @@ } } }, - "revision": "20230929", + "revision": "20231006", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -2886,6 +2886,20 @@ "object": { "description": "Cloud Storage object containing the source. This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`) containing source to build.", "type": "string" + }, + "sourceFetcher": { + "description": "Optional. Option to specify the tool to fetch the source file for the build.", + "enum": [ + "SOURCE_FETCHER_UNSPECIFIED", + "GSUTIL", + "GCS_FETCHER" + ], + "enumDescriptions": [ + "Unspecified defaults to GSUTIL.", + "Use the \"gsutil\" tool to download the source file.", + "Use the Cloud Storage Fetcher tool to download the source file." + ], + "type": "string" } }, "type": "object" diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index 7dc045f8831..f50797a64fd 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -3046,6 +3046,16 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1StorageSource struct { // source to build. Object string `json:"object,omitempty"` + // SourceFetcher: Optional. Option to specify the tool to fetch the + // source file for the build. + // + // Possible values: + // "SOURCE_FETCHER_UNSPECIFIED" - Unspecified defaults to GSUTIL. + // "GSUTIL" - Use the "gsutil" tool to download the source file. + // "GCS_FETCHER" - Use the Cloud Storage Fetcher tool to download the + // source file. + SourceFetcher string `json:"sourceFetcher,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bucket") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json index f119bb6fc2c..97ecf8fcef5 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-api.json +++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json @@ -119,7 +119,7 @@ ], "parameters": { "name": { - "description": "Required. The resource name of the Assessment, in the format \"projects/{project}/assessments/{assessment}\".", + "description": "Required. The resource name of the Assessment, in the format `projects/{project}/assessments/{assessment}`.", "location": "path", "pattern": "^projects/[^/]+/assessments/[^/]+$", "required": true, @@ -147,7 +147,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which the assessment will be created, in the format \"projects/{project}\".", + "description": "Required. The name of the project in which the assessment will be created, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -179,7 +179,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project this policy will apply to, in the format \"projects/{project}\".", + "description": "Required. The name of the project this policy will apply to, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -207,7 +207,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the policy to be deleted, in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "Required. The name of the policy to be deleted, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "location": "path", "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", "required": true, @@ -232,7 +232,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the requested policy, in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "Required. The name of the requested policy, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "location": "path", "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", "required": true, @@ -268,7 +268,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project to list the policies for, in the format \"projects/{project}\".", + "description": "Required. The name of the project to list the policies for, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -293,7 +293,7 @@ ], "parameters": { "name": { - "description": "The resource name for the FirewallPolicy in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "The resource name for the FirewallPolicy in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "location": "path", "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", "required": true, @@ -331,7 +331,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which the key will be created, in the format \"projects/{project}\".", + "description": "Required. The name of the project in which the key will be created, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -359,7 +359,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the key to be deleted, in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The name of the key to be deleted, in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -384,7 +384,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the requested key, in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The name of the requested key, in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -409,7 +409,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the requested metrics, in the format \"projects/{project}/keys/{key}/metrics\".", + "description": "Required. The name of the requested metrics, in the format `projects/{project}/keys/{key}/metrics`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+/metrics$", "required": true, @@ -445,7 +445,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project that contains the keys that will be listed, in the format \"projects/{project}\".", + "description": "Required. The name of the project that contains the keys that will be listed, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -470,7 +470,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the key to be migrated, in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The name of the key to be migrated, in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -498,7 +498,7 @@ ], "parameters": { "name": { - "description": "The resource name for the Key in the format \"projects/{project}/keys/{key}\".", + "description": "The resource name for the Key in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -532,7 +532,7 @@ ], "parameters": { "key": { - "description": "Required. The public key name linked to the requested secret key in the format \"projects/{project}/keys/{key}\".", + "description": "Required. The public key name linked to the requested secret key in the format `projects/{project}/keys/{key}`.", "location": "path", "pattern": "^projects/[^/]+/keys/[^/]+$", "required": true, @@ -561,7 +561,7 @@ ], "parameters": { "project": { - "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: \"projects/{project}\".", + "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -604,7 +604,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project to list related account groups from, in the format \"projects/{project}\".", + "description": "Required. The name of the project to list related account groups from, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -666,7 +666,7 @@ } } }, - "revision": "20230917", + "revision": "20231008", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -674,7 +674,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment", "properties": { "labels": { - "description": "Labels for this request.", + "description": "Output only. Labels for this request.", "items": { "enum": [ "ACCOUNT_DEFENDER_LABEL_UNSPECIFIED", @@ -692,6 +692,7 @@ ], "type": "string" }, + "readOnly": true, "type": "array" } }, @@ -702,14 +703,14 @@ "id": "GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo", "properties": { "endpoints": { - "description": "Endpoints that can be used for identity verification.", + "description": "Optional. Endpoints that can be used for identity verification.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1EndpointVerificationInfo" }, "type": "array" }, "languageCode": { - "description": "Language code preference for the verification message, set as a IETF BCP 47 language code.", + "description": "Optional. Language code preference for the verification message, set as a IETF BCP 47 language code.", "type": "string" }, "latestVerificationResult": { @@ -754,18 +755,18 @@ "id": "GoogleCloudRecaptchaenterpriseV1AndroidKeySettings", "properties": { "allowAllPackageNames": { - "description": "If set to true, allowed_package_names are not enforced.", + "description": "Optional. If set to true, allowed_package_names are not enforced.", "type": "boolean" }, "allowedPackageNames": { - "description": "Android package names of apps allowed to use the key. Example: 'com.companyname.appname'", + "description": "Optional. Android package names of apps allowed to use the key. Example: 'com.companyname.appname'", "items": { "type": "string" }, "type": "array" }, "supportNonGoogleAppStoreDistribution": { - "description": "Set to true for keys that are used in an Android application that is available for download in app stores in addition to the Google Play Store.", + "description": "Optional. Set to true for keys that are used in an Android application that is available for download in app stores in addition to the Google Play Store.", "type": "boolean" } }, @@ -884,23 +885,26 @@ "properties": { "accountDefenderAssessment": { "$ref": "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment", - "description": "Assessment returned by account defender when a hashed_account_id is provided." + "description": "Output only. Assessment returned by account defender when a hashed_account_id is provided.", + "readOnly": true }, "accountVerification": { "$ref": "GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo", - "description": "Account verification information for identity verification. The assessment event must include a token and site key to use this feature." + "description": "Optional. Account verification information for identity verification. The assessment event must include a token and site key to use this feature." }, "event": { "$ref": "GoogleCloudRecaptchaenterpriseV1Event", - "description": "The event being assessed." + "description": "Optional. The event being assessed." }, "firewallPolicyAssessment": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment", - "description": "Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation." + "description": "Output only. Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation.", + "readOnly": true }, "fraudPreventionAssessment": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment", - "description": "Assessment returned by Fraud Prevention when TransactionData is provided." + "description": "Output only. Assessment returned by Fraud Prevention when TransactionData is provided.", + "readOnly": true }, "fraudSignals": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudSignals", @@ -908,13 +912,13 @@ "readOnly": true }, "name": { - "description": "Output only. The resource name for the Assessment in the format \"projects/{project}/assessments/{assessment}\".", + "description": "Output only. The resource name for the Assessment in the format `projects/{project}/assessments/{assessment}`.", "readOnly": true, "type": "string" }, "privatePasswordLeakVerification": { "$ref": "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification", - "description": "The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials." + "description": "Optional. The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials." }, "riskAnalysis": { "$ref": "GoogleCloudRecaptchaenterpriseV1RiskAnalysis", @@ -1011,7 +1015,7 @@ "type": "array" }, "ja3": { - "description": "Optional. Optional JA3 fingerprint for SSL clients.", + "description": "Optional. JA3 fingerprint for SSL clients.", "type": "string" }, "requestedUri": { @@ -1095,11 +1099,11 @@ "id": "GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction", "properties": { "key": { - "description": "The header key to set in the request to the backend server.", + "description": "Optional. The header key to set in the request to the backend server.", "type": "string" }, "value": { - "description": "The header value to set in the request to the backend server.", + "description": "Optional. The header value to set in the request to the backend server.", "type": "string" } }, @@ -1110,7 +1114,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction", "properties": { "path": { - "description": "The address to redirect to. The target is a relative path in the current host. Example: \"/blog/404.html\".", + "description": "Optional. The address to redirect to. The target is a relative path in the current host. Example: \"/blog/404.html\".", "type": "string" } }, @@ -1121,26 +1125,26 @@ "id": "GoogleCloudRecaptchaenterpriseV1FirewallPolicy", "properties": { "actions": { - "description": "The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as AllowAction, BlockAction or SubstituteAction. Zero or more non-terminal actions such as SetHeader might be specified. A single policy can contain up to 16 actions.", + "description": "Optional. The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as `AllowAction`, `BlockAction` or `SubstituteAction`. Zero or more non-terminal actions such as `SetHeader` might be specified. A single policy can contain up to 16 actions.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallAction" }, "type": "array" }, "condition": { - "description": "A CEL (Common Expression Language) conditional expression that specifies if this policy applies to an incoming user request. If this condition evaluates to true and the requested path matched the path pattern, the associated actions should be executed by the caller. The condition string is checked for CEL syntax correctness on creation. For more information, see the [CEL spec](https://github.com/google/cel-spec) and its [language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md). A condition has a max length of 500 characters.", + "description": "Optional. A CEL (Common Expression Language) conditional expression that specifies if this policy applies to an incoming user request. If this condition evaluates to true and the requested path matched the path pattern, the associated actions should be executed by the caller. The condition string is checked for CEL syntax correctness on creation. For more information, see the [CEL spec](https://github.com/google/cel-spec) and its [language definition](https://github.com/google/cel-spec/blob/master/doc/langdef.md). A condition has a max length of 500 characters.", "type": "string" }, "description": { - "description": "A description of what this policy aims to achieve, for convenience purposes. The description can at most include 256 UTF-8 characters.", + "description": "Optional. A description of what this policy aims to achieve, for convenience purposes. The description can at most include 256 UTF-8 characters.", "type": "string" }, "name": { - "description": "The resource name for the FirewallPolicy in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + "description": "The resource name for the FirewallPolicy in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", "type": "string" }, "path": { - "description": "The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters.", + "description": "Optional. The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters.", "type": "string" } }, @@ -1152,7 +1156,8 @@ "properties": { "error": { "$ref": "GoogleRpcStatus", - "description": "If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty." + "description": "Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty.", + "readOnly": true }, "firewallPolicy": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallPolicy", @@ -1168,19 +1173,23 @@ "properties": { "behavioralTrustVerdict": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict", - "description": "Assessment of this transaction for behavioral trust." + "description": "Output only. Assessment of this transaction for behavioral trust.", + "readOnly": true }, "cardTestingVerdict": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict", - "description": "Assessment of this transaction for risk of being part of a card testing attack." + "description": "Output only. Assessment of this transaction for risk of being part of a card testing attack.", + "readOnly": true }, "stolenInstrumentVerdict": { "$ref": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict", - "description": "Assessment of this transaction for risk of a stolen instrument." + "description": "Output only. Assessment of this transaction for risk of a stolen instrument.", + "readOnly": true }, "transactionRisk": { - "description": "Probability of this transaction being fraudulent. Summarizes the combined risk of attack vectors below. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction being fraudulent. Summarizes the combined risk of attack vectors below. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1191,8 +1200,9 @@ "id": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict", "properties": { "trust": { - "description": "Probability of this transaction attempt being executed in a behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction attempt being executed in a behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1203,8 +1213,9 @@ "id": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict", "properties": { "risk": { - "description": "Probability of this transaction attempt being part of a card testing attack. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction attempt being part of a card testing attack. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1215,8 +1226,9 @@ "id": "GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict", "properties": { "risk": { - "description": "Probability of this transaction being executed with a stolen instrument. Values are from 0.0 (lowest) to 1.0 (highest).", + "description": "Output only. Probability of this transaction being executed with a stolen instrument. Values are from 0.0 (lowest) to 1.0 (highest).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1290,11 +1302,11 @@ "id": "GoogleCloudRecaptchaenterpriseV1IOSKeySettings", "properties": { "allowAllBundleIds": { - "description": "If set to true, allowed_bundle_ids are not enforced.", + "description": "Optional. If set to true, allowed_bundle_ids are not enforced.", "type": "boolean" }, "allowedBundleIds": { - "description": "iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'", + "description": "Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'", "items": { "type": "string" }, @@ -1302,7 +1314,7 @@ }, "appleDeveloperId": { "$ref": "GoogleCloudRecaptchaenterpriseV1AppleDeveloperId", - "description": "Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app." + "description": "Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app." } }, "type": "object" @@ -1322,7 +1334,7 @@ "type": "string" }, "displayName": { - "description": "Human-readable display name of this key. Modifiable by user.", + "description": "Required. Human-readable display name of this key. Modifiable by user.", "type": "string" }, "iosSettings": { @@ -1333,20 +1345,20 @@ "additionalProperties": { "type": "string" }, - "description": "See Creating and managing labels.", + "description": "Optional. See [Creating and managing labels] (https://cloud.google.com/recaptcha-enterprise/docs/labels).", "type": "object" }, "name": { - "description": "The resource name for the Key in the format \"projects/{project}/keys/{key}\".", + "description": "The resource name for the Key in the format `projects/{project}/keys/{key}`.", "type": "string" }, "testingOptions": { "$ref": "GoogleCloudRecaptchaenterpriseV1TestingOptions", - "description": "Options for user acceptance testing." + "description": "Optional. Options for user acceptance testing." }, "wafSettings": { "$ref": "GoogleCloudRecaptchaenterpriseV1WafSettings", - "description": "Settings for WAF" + "description": "Optional. Settings for WAF" }, "webSettings": { "$ref": "GoogleCloudRecaptchaenterpriseV1WebKeySettings", @@ -1439,7 +1451,7 @@ "type": "array" }, "name": { - "description": "Output only. The name of the metrics, in the format \"projects/{project}/keys/{key}/metrics\".", + "description": "Output only. The name of the metrics, in the format `projects/{project}/keys/{key}/metrics`.", "readOnly": true, "type": "string" }, @@ -1488,7 +1500,7 @@ "type": "string" }, "lookupHashPrefix": { - "description": "Optional. Exactly 26-bit prefix of the SHA-256 hash of the canonicalized username. It is used to look up password leaks associated with that hash prefix.", + "description": "Required. Exactly 26-bit prefix of the SHA-256 hash of the canonicalized username. It is used to look up password leaks associated with that hash prefix.", "format": "byte", "type": "string" }, @@ -1544,14 +1556,15 @@ "id": "GoogleCloudRecaptchaenterpriseV1RiskAnalysis", "properties": { "extendedVerdictReasons": { - "description": "Extended verdict reasons to be used for experimentation only. The set of possible reasons is subject to change.", + "description": "Output only. Extended verdict reasons to be used for experimentation only. The set of possible reasons is subject to change.", "items": { "type": "string" }, + "readOnly": true, "type": "array" }, "reasons": { - "description": "Reasons contributing to the risk analysis verdict.", + "description": "Output only. Reasons contributing to the risk analysis verdict.", "items": { "enum": [ "CLASSIFICATION_REASON_UNSPECIFIED", @@ -1575,11 +1588,13 @@ ], "type": "string" }, + "readOnly": true, "type": "array" }, "score": { - "description": "Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic).", + "description": "Output only. Legitimate event score from 0.0 to 1.0. (1.0 means very likely legitimate traffic while 0.0 means very likely non-legitimate traffic).", "format": "float", + "readOnly": true, "type": "number" } }, @@ -1662,7 +1677,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1TestingOptions", "properties": { "testingChallenge": { - "description": "For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.", + "description": "Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.", "enum": [ "TESTING_CHALLENGE_UNSPECIFIED", "NOCAPTCHA", @@ -1676,7 +1691,7 @@ "type": "string" }, "testingScore": { - "description": "All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.", + "description": "Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.", "format": "float", "type": "number" } @@ -1688,24 +1703,28 @@ "id": "GoogleCloudRecaptchaenterpriseV1TokenProperties", "properties": { "action": { - "description": "Action name provided at token generation.", + "description": "Output only. Action name provided at token generation.", + "readOnly": true, "type": "string" }, "androidPackageName": { - "description": "The name of the Android package with which the token was generated (Android keys only).", + "description": "Output only. The name of the Android package with which the token was generated (Android keys only).", + "readOnly": true, "type": "string" }, "createTime": { - "description": "The timestamp corresponding to the generation of the token.", + "description": "Output only. The timestamp corresponding to the generation of the token.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "hostname": { - "description": "The hostname of the page on which the token was generated (Web keys only).", + "description": "Output only. The hostname of the page on which the token was generated (Web keys only).", + "readOnly": true, "type": "string" }, "invalidReason": { - "description": "Reason associated with the response when valid = false.", + "description": "Output only. Reason associated with the response when valid = false.", "enum": [ "INVALID_REASON_UNSPECIFIED", "UNKNOWN_INVALID_REASON", @@ -1724,67 +1743,70 @@ "The user verification token was not present.", "A retriable error (such as network failure) occurred on the browser. Could easily be simulated by an attacker." ], + "readOnly": true, "type": "string" }, "iosBundleId": { - "description": "The ID of the iOS bundle with which the token was generated (iOS keys only).", + "description": "Output only. The ID of the iOS bundle with which the token was generated (iOS keys only).", + "readOnly": true, "type": "string" }, "valid": { - "description": "Whether the provided user response token is valid. When valid = false, the reason could be specified in invalid_reason or it could also be due to a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey used to generate the token was different than the one specified in the assessment).", + "description": "Output only. Whether the provided user response token is valid. When valid = false, the reason could be specified in invalid_reason or it could also be due to a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey used to generate the token was different than the one specified in the assessment).", + "readOnly": true, "type": "boolean" } }, "type": "object" }, "GoogleCloudRecaptchaenterpriseV1TransactionData": { - "description": "Transaction data associated with a payment protected by reCAPTCHA Enterprise. All fields are optional.", + "description": "Transaction data associated with a payment protected by reCAPTCHA Enterprise.", "id": "GoogleCloudRecaptchaenterpriseV1TransactionData", "properties": { "billingAddress": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataAddress", - "description": "Address associated with the payment method when applicable." + "description": "Optional. Address associated with the payment method when applicable." }, "cardBin": { - "description": "The Bank Identification Number - generally the first 6 or 8 digits of the card.", + "description": "Optional. The Bank Identification Number - generally the first 6 or 8 digits of the card.", "type": "string" }, "cardLastFour": { - "description": "The last four digits of the card.", + "description": "Optional. The last four digits of the card.", "type": "string" }, "currencyCode": { - "description": "The currency code in ISO-4217 format.", + "description": "Optional. The currency code in ISO-4217 format.", "type": "string" }, "gatewayInfo": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo", - "description": "Information about the payment gateway's response to the transaction." + "description": "Optional. Information about the payment gateway's response to the transaction." }, "items": { - "description": "Items purchased in this transaction.", + "description": "Optional. Items purchased in this transaction.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataItem" }, "type": "array" }, "merchants": { - "description": "Information about the user or users fulfilling the transaction.", + "description": "Optional. Information about the user or users fulfilling the transaction.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataUser" }, "type": "array" }, "paymentMethod": { - "description": "The payment method for the transaction. The allowed values are: * credit-card * debit-card * gift-card * processor-{name} (If a third-party is used, for example, processor-paypal) * custom-{name} (If an alternative method is used, for example, custom-crypto)", + "description": "Optional. The payment method for the transaction. The allowed values are: * credit-card * debit-card * gift-card * processor-{name} (If a third-party is used, for example, processor-paypal) * custom-{name} (If an alternative method is used, for example, custom-crypto)", "type": "string" }, "shippingAddress": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataAddress", - "description": "Destination address if this transaction involves shipping a physical item." + "description": "Optional. Destination address if this transaction involves shipping a physical item." }, "shippingValue": { - "description": "The value of shipping in the specified currency. 0 for free or no shipping.", + "description": "Optional. The value of shipping in the specified currency. 0 for free or no shipping.", "format": "double", "type": "number" }, @@ -1794,10 +1816,10 @@ }, "user": { "$ref": "GoogleCloudRecaptchaenterpriseV1TransactionDataUser", - "description": "Information about the user paying/initiating the transaction." + "description": "Optional. Information about the user paying/initiating the transaction." }, "value": { - "description": "The decimal value of the transaction in the specified currency.", + "description": "Optional. The decimal value of the transaction in the specified currency.", "format": "double", "type": "number" } @@ -1809,30 +1831,30 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataAddress", "properties": { "address": { - "description": "The first lines of the address. The first line generally contains the street name and number, and further lines may include information such as an apartment number.", + "description": "Optional. The first lines of the address. The first line generally contains the street name and number, and further lines may include information such as an apartment number.", "items": { "type": "string" }, "type": "array" }, "administrativeArea": { - "description": "The state, province, or otherwise administrative area of the address.", + "description": "Optional. The state, province, or otherwise administrative area of the address.", "type": "string" }, "locality": { - "description": "The town/city of the address.", + "description": "Optional. The town/city of the address.", "type": "string" }, "postalCode": { - "description": "The postal or ZIP code of the address.", + "description": "Optional. The postal or ZIP code of the address.", "type": "string" }, "recipient": { - "description": "The recipient name, potentially including information such as \"care of\".", + "description": "Optional. The recipient name, potentially including information such as \"care of\".", "type": "string" }, "regionCode": { - "description": "The CLDR country/region of the address.", + "description": "Optional. The CLDR country/region of the address.", "type": "string" } }, @@ -1843,19 +1865,19 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo", "properties": { "avsResponseCode": { - "description": "AVS response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", + "description": "Optional. AVS response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", "type": "string" }, "cvvResponseCode": { - "description": "CVV response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", + "description": "Optional. CVV response code from the gateway (available only when reCAPTCHA Enterprise is called after authorization).", "type": "string" }, "gatewayResponseCode": { - "description": "Gateway response code describing the state of the transaction.", + "description": "Optional. Gateway response code describing the state of the transaction.", "type": "string" }, "name": { - "description": "Name of the gateway service (for example, stripe, square, paypal).", + "description": "Optional. Name of the gateway service (for example, stripe, square, paypal).", "type": "string" } }, @@ -1866,20 +1888,20 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataItem", "properties": { "merchantAccountId": { - "description": "When a merchant is specified, its corresponding account_id. Necessary to populate marketplace-style transactions.", + "description": "Optional. When a merchant is specified, its corresponding account_id. Necessary to populate marketplace-style transactions.", "type": "string" }, "name": { - "description": "The full name of the item.", + "description": "Optional. The full name of the item.", "type": "string" }, "quantity": { - "description": "The quantity of this item that is being purchased.", + "description": "Optional. The quantity of this item that is being purchased.", "format": "int64", "type": "string" }, "value": { - "description": "The value per item that the user is paying, in the transaction currency, after discounts.", + "description": "Optional. The value per item that the user is paying, in the transaction currency, after discounts.", "format": "double", "type": "number" } @@ -1891,28 +1913,28 @@ "id": "GoogleCloudRecaptchaenterpriseV1TransactionDataUser", "properties": { "accountId": { - "description": "Unique account identifier for this user. If using account defender, this should match the hashed_account_id field. Otherwise, a unique and persistent identifier for this account.", + "description": "Optional. Unique account identifier for this user. If using account defender, this should match the hashed_account_id field. Otherwise, a unique and persistent identifier for this account.", "type": "string" }, "creationMs": { - "description": "The epoch milliseconds of the user's account creation.", + "description": "Optional. The epoch milliseconds of the user's account creation.", "format": "int64", "type": "string" }, "email": { - "description": "The email address of the user.", + "description": "Optional. The email address of the user.", "type": "string" }, "emailVerified": { - "description": "Whether the email has been verified to be accessible by the user (OTP or similar).", + "description": "Optional. Whether the email has been verified to be accessible by the user (OTP or similar).", "type": "boolean" }, "phoneNumber": { - "description": "The phone number of the user, with country code.", + "description": "Optional. The phone number of the user, with country code.", "type": "string" }, "phoneVerified": { - "description": "Whether the phone number has been verified to be accessible by the user (OTP or similar).", + "description": "Optional. Whether the phone number has been verified to be accessible by the user (OTP or similar).", "type": "boolean" } }, @@ -2029,22 +2051,22 @@ "id": "GoogleCloudRecaptchaenterpriseV1WebKeySettings", "properties": { "allowAllDomains": { - "description": "If set to true, it means allowed_domains will not be enforced.", + "description": "Optional. If set to true, it means allowed_domains will not be enforced.", "type": "boolean" }, "allowAmpTraffic": { - "description": "If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.", + "description": "Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.", "type": "boolean" }, "allowedDomains": { - "description": "Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'", + "description": "Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'", "items": { "type": "string" }, "type": "array" }, "challengeSecurityPreference": { - "description": "Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.", + "description": "Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.", "enum": [ "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED", "USABILITY", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go index ec2479efd1f..952357e0007 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go +++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go @@ -235,7 +235,7 @@ type ProjectsRelatedaccountgroupsMembershipsService struct { // GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment: Account // defender risk assessment. type GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment struct { - // Labels: Labels for this request. + // Labels: Output only. Labels for this request. // // Possible values: // "ACCOUNT_DEFENDER_LABEL_UNSPECIFIED" - Default unspecified type. @@ -278,11 +278,12 @@ func (s *GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment) MarshalJSON( // GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo: Information // about account verification, used for identity verification. type GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo struct { - // Endpoints: Endpoints that can be used for identity verification. + // Endpoints: Optional. Endpoints that can be used for identity + // verification. Endpoints []*GoogleCloudRecaptchaenterpriseV1EndpointVerificationInfo `json:"endpoints,omitempty"` - // LanguageCode: Language code preference for the verification message, - // set as a IETF BCP 47 language code. + // LanguageCode: Optional. Language code preference for the verification + // message, set as a IETF BCP 47 language code. LanguageCode string `json:"languageCode,omitempty"` // LatestVerificationResult: Output only. Result of the latest account @@ -344,17 +345,17 @@ func (s *GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo) MarshalJSON() // GoogleCloudRecaptchaenterpriseV1AndroidKeySettings: Settings specific // to keys that can be used by Android apps. type GoogleCloudRecaptchaenterpriseV1AndroidKeySettings struct { - // AllowAllPackageNames: If set to true, allowed_package_names are not - // enforced. + // AllowAllPackageNames: Optional. If set to true, allowed_package_names + // are not enforced. AllowAllPackageNames bool `json:"allowAllPackageNames,omitempty"` - // AllowedPackageNames: Android package names of apps allowed to use the - // key. Example: 'com.companyname.appname' + // AllowedPackageNames: Optional. Android package names of apps allowed + // to use the key. Example: 'com.companyname.appname' AllowedPackageNames []string `json:"allowedPackageNames,omitempty"` - // SupportNonGoogleAppStoreDistribution: Set to true for keys that are - // used in an Android application that is available for download in app - // stores in addition to the Google Play Store. + // SupportNonGoogleAppStoreDistribution: Optional. Set to true for keys + // that are used in an Android application that is available for + // download in app stores in addition to the Google Play Store. SupportNonGoogleAppStoreDistribution bool `json:"supportNonGoogleAppStoreDistribution,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -538,25 +539,25 @@ func (s *GoogleCloudRecaptchaenterpriseV1AppleDeveloperId) MarshalJSON() ([]byte // GoogleCloudRecaptchaenterpriseV1Assessment: A reCAPTCHA Enterprise // assessment resource. type GoogleCloudRecaptchaenterpriseV1Assessment struct { - // AccountDefenderAssessment: Assessment returned by account defender - // when a hashed_account_id is provided. + // AccountDefenderAssessment: Output only. Assessment returned by + // account defender when a hashed_account_id is provided. AccountDefenderAssessment *GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment `json:"accountDefenderAssessment,omitempty"` - // AccountVerification: Account verification information for identity - // verification. The assessment event must include a token and site key - // to use this feature. + // AccountVerification: Optional. Account verification information for + // identity verification. The assessment event must include a token and + // site key to use this feature. AccountVerification *GoogleCloudRecaptchaenterpriseV1AccountVerificationInfo `json:"accountVerification,omitempty"` - // Event: The event being assessed. + // Event: Optional. The event being assessed. Event *GoogleCloudRecaptchaenterpriseV1Event `json:"event,omitempty"` - // FirewallPolicyAssessment: Assessment returned when firewall policies - // belonging to the project are evaluated using the field - // firewall_policy_evaluation. + // FirewallPolicyAssessment: Output only. Assessment returned when + // firewall policies belonging to the project are evaluated using the + // field firewall_policy_evaluation. FirewallPolicyAssessment *GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment `json:"firewallPolicyAssessment,omitempty"` - // FraudPreventionAssessment: Assessment returned by Fraud Prevention - // when TransactionData is provided. + // FraudPreventionAssessment: Output only. Assessment returned by Fraud + // Prevention when TransactionData is provided. FraudPreventionAssessment *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment `json:"fraudPreventionAssessment,omitempty"` // FraudSignals: Output only. Fraud Signals specific to the users @@ -564,10 +565,10 @@ type GoogleCloudRecaptchaenterpriseV1Assessment struct { FraudSignals *GoogleCloudRecaptchaenterpriseV1FraudSignals `json:"fraudSignals,omitempty"` // Name: Output only. The resource name for the Assessment in the format - // "projects/{project}/assessments/{assessment}". + // `projects/{project}/assessments/{assessment}`. Name string `json:"name,omitempty"` - // PrivatePasswordLeakVerification: The private password leak + // PrivatePasswordLeakVerification: Optional. The private password leak // verification field contains the parameters that are used to to check // for leaks privately without sharing user credentials. PrivatePasswordLeakVerification *GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification `json:"privatePasswordLeakVerification,omitempty"` @@ -721,7 +722,7 @@ type GoogleCloudRecaptchaenterpriseV1Event struct { // Headers: Optional. HTTP header information about the request. Headers []string `json:"headers,omitempty"` - // Ja3: Optional. Optional JA3 fingerprint for SSL clients. + // Ja3: Optional. JA3 fingerprint for SSL clients. Ja3 string `json:"ja3,omitempty"` // RequestedUri: Optional. The URI resource the user requested that @@ -847,10 +848,12 @@ type GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction struct { // This can be used to trigger custom protection implemented on the // backend. type GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction struct { - // Key: The header key to set in the request to the backend server. + // Key: Optional. The header key to set in the request to the backend + // server. Key string `json:"key,omitempty"` - // Value: The header value to set in the request to the backend server. + // Value: Optional. The header value to set in the request to the + // backend server. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Key") to @@ -880,8 +883,8 @@ func (s *GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction) MarshalJ // substitute action transparently serves a different page than the one // requested. type GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction struct { - // Path: The address to redirect to. The target is a relative path in - // the current host. Example: "/blog/404.html". + // Path: Optional. The address to redirect to. The target is a relative + // path in the current host. Example: "/blog/404.html". Path string `json:"path,omitempty"` // ForceSendFields is a list of field names (e.g. "Path") to @@ -910,36 +913,36 @@ func (s *GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction) Marshal // GoogleCloudRecaptchaenterpriseV1FirewallPolicy: A FirewallPolicy // represents a single matching pattern and resulting actions to take. type GoogleCloudRecaptchaenterpriseV1FirewallPolicy struct { - // Actions: The actions that the caller should take regarding user - // access. There should be at most one terminal action. A terminal - // action is any action that forces a response, such as AllowAction, - // BlockAction or SubstituteAction. Zero or more non-terminal actions - // such as SetHeader might be specified. A single policy can contain up - // to 16 actions. + // Actions: Optional. The actions that the caller should take regarding + // user access. There should be at most one terminal action. A terminal + // action is any action that forces a response, such as `AllowAction`, + // `BlockAction` or `SubstituteAction`. Zero or more non-terminal + // actions such as `SetHeader` might be specified. A single policy can + // contain up to 16 actions. Actions []*GoogleCloudRecaptchaenterpriseV1FirewallAction `json:"actions,omitempty"` - // Condition: A CEL (Common Expression Language) conditional expression - // that specifies if this policy applies to an incoming user request. If - // this condition evaluates to true and the requested path matched the - // path pattern, the associated actions should be executed by the - // caller. The condition string is checked for CEL syntax correctness on - // creation. For more information, see the CEL spec + // Condition: Optional. A CEL (Common Expression Language) conditional + // expression that specifies if this policy applies to an incoming user + // request. If this condition evaluates to true and the requested path + // matched the path pattern, the associated actions should be executed + // by the caller. The condition string is checked for CEL syntax + // correctness on creation. For more information, see the CEL spec // (https://github.com/google/cel-spec) and its language definition // (https://github.com/google/cel-spec/blob/master/doc/langdef.md). A // condition has a max length of 500 characters. Condition string `json:"condition,omitempty"` - // Description: A description of what this policy aims to achieve, for - // convenience purposes. The description can at most include 256 UTF-8 - // characters. + // Description: Optional. A description of what this policy aims to + // achieve, for convenience purposes. The description can at most + // include 256 UTF-8 characters. Description string `json:"description,omitempty"` // Name: The resource name for the FirewallPolicy in the format - // "projects/{project}/firewallpolicies/{firewallpolicy}". + // `projects/{project}/firewallpolicies/{firewallpolicy}`. Name string `json:"name,omitempty"` - // Path: The path for which this policy applies, specified as a glob - // pattern. For more information on glob, see the manual page + // Path: Optional. The path for which this policy applies, specified as + // a glob pattern. For more information on glob, see the manual page // (https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max // length of 200 characters. Path string `json:"path,omitempty"` @@ -974,8 +977,8 @@ func (s *GoogleCloudRecaptchaenterpriseV1FirewallPolicy) MarshalJSON() ([]byte, // GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment: Policy // config assessment. type GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment struct { - // Error: If the processing of a policy config fails, an error will be - // populated and the firewall_policy will be left empty. + // Error: Output only. If the processing of a policy config fails, an + // error will be populated and the firewall_policy will be left empty. Error *GoogleRpcStatus `json:"error,omitempty"` // FirewallPolicy: Output only. The policy that matched the request. If @@ -1009,21 +1012,21 @@ func (s *GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment) MarshalJSON() // GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment: Assessment // for Fraud Prevention. type GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment struct { - // BehavioralTrustVerdict: Assessment of this transaction for behavioral - // trust. + // BehavioralTrustVerdict: Output only. Assessment of this transaction + // for behavioral trust. BehavioralTrustVerdict *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict `json:"behavioralTrustVerdict,omitempty"` - // CardTestingVerdict: Assessment of this transaction for risk of being - // part of a card testing attack. + // CardTestingVerdict: Output only. Assessment of this transaction for + // risk of being part of a card testing attack. CardTestingVerdict *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict `json:"cardTestingVerdict,omitempty"` - // StolenInstrumentVerdict: Assessment of this transaction for risk of a - // stolen instrument. + // StolenInstrumentVerdict: Output only. Assessment of this transaction + // for risk of a stolen instrument. StolenInstrumentVerdict *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict `json:"stolenInstrumentVerdict,omitempty"` - // TransactionRisk: Probability of this transaction being fraudulent. - // Summarizes the combined risk of attack vectors below. Values are from - // 0.0 (lowest) to 1.0 (highest). + // TransactionRisk: Output only. Probability of this transaction being + // fraudulent. Summarizes the combined risk of attack vectors below. + // Values are from 0.0 (lowest) to 1.0 (highest). TransactionRisk float64 `json:"transactionRisk,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -1068,9 +1071,9 @@ func (s *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessment) UnmarshalJSO // GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTru // stVerdict: Information about behavioral trust of the transaction. type GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrustVerdict struct { - // Trust: Probability of this transaction attempt being executed in a - // behaviorally trustworthy way. Values are from 0.0 (lowest) to 1.0 - // (highest). + // Trust: Output only. Probability of this transaction attempt being + // executed in a behaviorally trustworthy way. Values are from 0.0 + // (lowest) to 1.0 (highest). Trust float64 `json:"trust,omitempty"` // ForceSendFields is a list of field names (e.g. "Trust") to @@ -1114,8 +1117,9 @@ func (s *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentBehavioralTrus // rdict: Information about card testing fraud, where an adversary is // testing fraudulently obtained cards or brute forcing their details. type GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVerdict struct { - // Risk: Probability of this transaction attempt being part of a card - // testing attack. Values are from 0.0 (lowest) to 1.0 (highest). + // Risk: Output only. Probability of this transaction attempt being part + // of a card testing attack. Values are from 0.0 (lowest) to 1.0 + // (highest). Risk float64 `json:"risk,omitempty"` // ForceSendFields is a list of field names (e.g. "Risk") to @@ -1160,8 +1164,9 @@ func (s *GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentCardTestingVer // is not the legitimate owner of the instrument being used for the // purchase. type GoogleCloudRecaptchaenterpriseV1FraudPreventionAssessmentStolenInstrumentVerdict struct { - // Risk: Probability of this transaction being executed with a stolen - // instrument. Values are from 0.0 (lowest) to 1.0 (highest). + // Risk: Output only. Probability of this transaction being executed + // with a stolen instrument. Values are from 0.0 (lowest) to 1.0 + // (highest). Risk float64 `json:"risk,omitempty"` // ForceSendFields is a list of field names (e.g. "Risk") to @@ -1329,20 +1334,20 @@ func (s *GoogleCloudRecaptchaenterpriseV1FraudSignalsUserSignals) UnmarshalJSON( // GoogleCloudRecaptchaenterpriseV1IOSKeySettings: Settings specific to // keys that can be used by iOS apps. type GoogleCloudRecaptchaenterpriseV1IOSKeySettings struct { - // AllowAllBundleIds: If set to true, allowed_bundle_ids are not - // enforced. + // AllowAllBundleIds: Optional. If set to true, allowed_bundle_ids are + // not enforced. AllowAllBundleIds bool `json:"allowAllBundleIds,omitempty"` - // AllowedBundleIds: iOS bundle ids of apps allowed to use the key. - // Example: 'com.companyname.productname.appname' + // AllowedBundleIds: Optional. iOS bundle ids of apps allowed to use the + // key. Example: 'com.companyname.productname.appname' AllowedBundleIds []string `json:"allowedBundleIds,omitempty"` - // AppleDeveloperId: Apple Developer account details for the app that is - // protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages - // platform-specific checks like Apple App Attest and Apple DeviceCheck - // to protect your app from abuse. Providing these fields allows - // reCAPTCHA Enterprise to get a better assessment of the integrity of - // your app. + // AppleDeveloperId: Optional. Apple Developer account details for the + // app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise + // leverages platform-specific checks like Apple App Attest and Apple + // DeviceCheck to protect your app from abuse. Providing these fields + // allows reCAPTCHA Enterprise to get a better assessment of the + // integrity of your app. AppleDeveloperId *GoogleCloudRecaptchaenterpriseV1AppleDeveloperId `json:"appleDeveloperId,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowAllBundleIds") @@ -1380,24 +1385,25 @@ type GoogleCloudRecaptchaenterpriseV1Key struct { // of this key. CreateTime string `json:"createTime,omitempty"` - // DisplayName: Human-readable display name of this key. Modifiable by - // user. + // DisplayName: Required. Human-readable display name of this key. + // Modifiable by user. DisplayName string `json:"displayName,omitempty"` // IosSettings: Settings for keys that can be used by iOS apps. IosSettings *GoogleCloudRecaptchaenterpriseV1IOSKeySettings `json:"iosSettings,omitempty"` - // Labels: See Creating and managing labels. + // Labels: Optional. See [Creating and managing labels] + // (https://cloud.google.com/recaptcha-enterprise/docs/labels). Labels map[string]string `json:"labels,omitempty"` // Name: The resource name for the Key in the format - // "projects/{project}/keys/{key}". + // `projects/{project}/keys/{key}`. Name string `json:"name,omitempty"` - // TestingOptions: Options for user acceptance testing. + // TestingOptions: Optional. Options for user acceptance testing. TestingOptions *GoogleCloudRecaptchaenterpriseV1TestingOptions `json:"testingOptions,omitempty"` - // WafSettings: Settings for WAF + // WafSettings: Optional. Settings for WAF WafSettings *GoogleCloudRecaptchaenterpriseV1WafSettings `json:"wafSettings,omitempty"` // WebSettings: Settings for keys that can be used by websites. @@ -1591,7 +1597,7 @@ type GoogleCloudRecaptchaenterpriseV1Metrics struct { ChallengeMetrics []*GoogleCloudRecaptchaenterpriseV1ChallengeMetrics `json:"challengeMetrics,omitempty"` // Name: Output only. The name of the metrics, in the format - // "projects/{project}/keys/{key}/metrics". + // `projects/{project}/keys/{key}/metrics`. Name string `json:"name,omitempty"` // ScoreMetrics: Metrics will be continuous and in order by dates, and @@ -1682,7 +1688,7 @@ type GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification struct { // returned through `reencrypted_user_credentials_hash`. EncryptedUserCredentialsHash string `json:"encryptedUserCredentialsHash,omitempty"` - // LookupHashPrefix: Optional. Exactly 26-bit prefix of the SHA-256 hash + // LookupHashPrefix: Required. Exactly 26-bit prefix of the SHA-256 hash // of the canonicalized username. It is used to look up password leaks // associated with that hash prefix. LookupHashPrefix string `json:"lookupHashPrefix,omitempty"` @@ -1827,12 +1833,13 @@ func (s *GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse) Marsha // GoogleCloudRecaptchaenterpriseV1RiskAnalysis: Risk analysis result // for an event. type GoogleCloudRecaptchaenterpriseV1RiskAnalysis struct { - // ExtendedVerdictReasons: Extended verdict reasons to be used for - // experimentation only. The set of possible reasons is subject to - // change. + // ExtendedVerdictReasons: Output only. Extended verdict reasons to be + // used for experimentation only. The set of possible reasons is subject + // to change. ExtendedVerdictReasons []string `json:"extendedVerdictReasons,omitempty"` - // Reasons: Reasons contributing to the risk analysis verdict. + // Reasons: Output only. Reasons contributing to the risk analysis + // verdict. // // Possible values: // "CLASSIFICATION_REASON_UNSPECIFIED" - Default unspecified type. @@ -1852,9 +1859,9 @@ type GoogleCloudRecaptchaenterpriseV1RiskAnalysis struct { // characteristics of chargebacks for fraud. Reasons []string `json:"reasons,omitempty"` - // Score: Legitimate event score from 0.0 to 1.0. (1.0 means very likely - // legitimate traffic while 0.0 means very likely non-legitimate - // traffic). + // Score: Output only. Legitimate event score from 0.0 to 1.0. (1.0 + // means very likely legitimate traffic while 0.0 means very likely + // non-legitimate traffic). Score float64 `json:"score,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2050,7 +2057,7 @@ func (s *GoogleCloudRecaptchaenterpriseV1SearchRelatedAccountGroupMembershipsRes // GoogleCloudRecaptchaenterpriseV1TestingOptions: Options for user // acceptance testing. type GoogleCloudRecaptchaenterpriseV1TestingOptions struct { - // TestingChallenge: For challenge-based keys only (CHECKBOX, + // TestingChallenge: Optional. For challenge-based keys only (CHECKBOX, // INVISIBLE), all challenge requests for this site will return // nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE. // @@ -2064,9 +2071,9 @@ type GoogleCloudRecaptchaenterpriseV1TestingOptions struct { // return an unsolvable challenge. TestingChallenge string `json:"testingChallenge,omitempty"` - // TestingScore: All assessments for this Key will return this score. - // Must be between 0 (likely not legitimate) and 1 (likely legitimate) - // inclusive. + // TestingScore: Optional. All assessments for this Key will return this + // score. Must be between 0 (likely not legitimate) and 1 (likely + // legitimate) inclusive. TestingScore float64 `json:"testingScore,omitempty"` // ForceSendFields is a list of field names (e.g. "TestingChallenge") to @@ -2110,23 +2117,23 @@ func (s *GoogleCloudRecaptchaenterpriseV1TestingOptions) UnmarshalJSON(data []by // GoogleCloudRecaptchaenterpriseV1TokenProperties: Properties of the // provided event token. type GoogleCloudRecaptchaenterpriseV1TokenProperties struct { - // Action: Action name provided at token generation. + // Action: Output only. Action name provided at token generation. Action string `json:"action,omitempty"` - // AndroidPackageName: The name of the Android package with which the - // token was generated (Android keys only). + // AndroidPackageName: Output only. The name of the Android package with + // which the token was generated (Android keys only). AndroidPackageName string `json:"androidPackageName,omitempty"` - // CreateTime: The timestamp corresponding to the generation of the - // token. + // CreateTime: Output only. The timestamp corresponding to the + // generation of the token. CreateTime string `json:"createTime,omitempty"` - // Hostname: The hostname of the page on which the token was generated - // (Web keys only). + // Hostname: Output only. The hostname of the page on which the token + // was generated (Web keys only). Hostname string `json:"hostname,omitempty"` - // InvalidReason: Reason associated with the response when valid = - // false. + // InvalidReason: Output only. Reason associated with the response when + // valid = false. // // Possible values: // "INVALID_REASON_UNSPECIFIED" - Default unspecified type. @@ -2140,15 +2147,15 @@ type GoogleCloudRecaptchaenterpriseV1TokenProperties struct { // occurred on the browser. Could easily be simulated by an attacker. InvalidReason string `json:"invalidReason,omitempty"` - // IosBundleId: The ID of the iOS bundle with which the token was - // generated (iOS keys only). + // IosBundleId: Output only. The ID of the iOS bundle with which the + // token was generated (iOS keys only). IosBundleId string `json:"iosBundleId,omitempty"` - // Valid: Whether the provided user response token is valid. When valid - // = false, the reason could be specified in invalid_reason or it could - // also be due to a user failing to solve a challenge or a sitekey - // mismatch (i.e the sitekey used to generate the token was different - // than the one specified in the assessment). + // Valid: Output only. Whether the provided user response token is + // valid. When valid = false, the reason could be specified in + // invalid_reason or it could also be due to a user failing to solve a + // challenge or a sitekey mismatch (i.e the sitekey used to generate the + // token was different than the one specified in the assessment). Valid bool `json:"valid,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -2175,47 +2182,46 @@ func (s *GoogleCloudRecaptchaenterpriseV1TokenProperties) MarshalJSON() ([]byte, } // GoogleCloudRecaptchaenterpriseV1TransactionData: Transaction data -// associated with a payment protected by reCAPTCHA Enterprise. All -// fields are optional. +// associated with a payment protected by reCAPTCHA Enterprise. type GoogleCloudRecaptchaenterpriseV1TransactionData struct { - // BillingAddress: Address associated with the payment method when - // applicable. + // BillingAddress: Optional. Address associated with the payment method + // when applicable. BillingAddress *GoogleCloudRecaptchaenterpriseV1TransactionDataAddress `json:"billingAddress,omitempty"` - // CardBin: The Bank Identification Number - generally the first 6 or 8 - // digits of the card. + // CardBin: Optional. The Bank Identification Number - generally the + // first 6 or 8 digits of the card. CardBin string `json:"cardBin,omitempty"` - // CardLastFour: The last four digits of the card. + // CardLastFour: Optional. The last four digits of the card. CardLastFour string `json:"cardLastFour,omitempty"` - // CurrencyCode: The currency code in ISO-4217 format. + // CurrencyCode: Optional. The currency code in ISO-4217 format. CurrencyCode string `json:"currencyCode,omitempty"` - // GatewayInfo: Information about the payment gateway's response to the - // transaction. + // GatewayInfo: Optional. Information about the payment gateway's + // response to the transaction. GatewayInfo *GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo `json:"gatewayInfo,omitempty"` - // Items: Items purchased in this transaction. + // Items: Optional. Items purchased in this transaction. Items []*GoogleCloudRecaptchaenterpriseV1TransactionDataItem `json:"items,omitempty"` - // Merchants: Information about the user or users fulfilling the - // transaction. + // Merchants: Optional. Information about the user or users fulfilling + // the transaction. Merchants []*GoogleCloudRecaptchaenterpriseV1TransactionDataUser `json:"merchants,omitempty"` - // PaymentMethod: The payment method for the transaction. The allowed - // values are: * credit-card * debit-card * gift-card * processor-{name} - // (If a third-party is used, for example, processor-paypal) * - // custom-{name} (If an alternative method is used, for example, - // custom-crypto) + // PaymentMethod: Optional. The payment method for the transaction. The + // allowed values are: * credit-card * debit-card * gift-card * + // processor-{name} (If a third-party is used, for example, + // processor-paypal) * custom-{name} (If an alternative method is used, + // for example, custom-crypto) PaymentMethod string `json:"paymentMethod,omitempty"` - // ShippingAddress: Destination address if this transaction involves - // shipping a physical item. + // ShippingAddress: Optional. Destination address if this transaction + // involves shipping a physical item. ShippingAddress *GoogleCloudRecaptchaenterpriseV1TransactionDataAddress `json:"shippingAddress,omitempty"` - // ShippingValue: The value of shipping in the specified currency. 0 for - // free or no shipping. + // ShippingValue: Optional. The value of shipping in the specified + // currency. 0 for free or no shipping. ShippingValue float64 `json:"shippingValue,omitempty"` // TransactionId: Unique identifier for the transaction. This custom @@ -2224,11 +2230,12 @@ type GoogleCloudRecaptchaenterpriseV1TransactionData struct { // the same transaction should use the same transaction id. TransactionId string `json:"transactionId,omitempty"` - // User: Information about the user paying/initiating the transaction. + // User: Optional. Information about the user paying/initiating the + // transaction. User *GoogleCloudRecaptchaenterpriseV1TransactionDataUser `json:"user,omitempty"` - // Value: The decimal value of the transaction in the specified - // currency. + // Value: Optional. The decimal value of the transaction in the + // specified currency. Value float64 `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "BillingAddress") to @@ -2274,26 +2281,26 @@ func (s *GoogleCloudRecaptchaenterpriseV1TransactionData) UnmarshalJSON(data []b // GoogleCloudRecaptchaenterpriseV1TransactionDataAddress: Structured // address format for billing and shipping addresses. type GoogleCloudRecaptchaenterpriseV1TransactionDataAddress struct { - // Address: The first lines of the address. The first line generally - // contains the street name and number, and further lines may include - // information such as an apartment number. + // Address: Optional. The first lines of the address. The first line + // generally contains the street name and number, and further lines may + // include information such as an apartment number. Address []string `json:"address,omitempty"` - // AdministrativeArea: The state, province, or otherwise administrative - // area of the address. + // AdministrativeArea: Optional. The state, province, or otherwise + // administrative area of the address. AdministrativeArea string `json:"administrativeArea,omitempty"` - // Locality: The town/city of the address. + // Locality: Optional. The town/city of the address. Locality string `json:"locality,omitempty"` - // PostalCode: The postal or ZIP code of the address. + // PostalCode: Optional. The postal or ZIP code of the address. PostalCode string `json:"postalCode,omitempty"` - // Recipient: The recipient name, potentially including information such - // as "care of". + // Recipient: Optional. The recipient name, potentially including + // information such as "care of". Recipient string `json:"recipient,omitempty"` - // RegionCode: The CLDR country/region of the address. + // RegionCode: Optional. The CLDR country/region of the address. RegionCode string `json:"regionCode,omitempty"` // ForceSendFields is a list of field names (e.g. "Address") to @@ -2322,20 +2329,22 @@ func (s *GoogleCloudRecaptchaenterpriseV1TransactionDataAddress) MarshalJSON() ( // GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo: Details // about the transaction from the gateway. type GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo struct { - // AvsResponseCode: AVS response code from the gateway (available only - // when reCAPTCHA Enterprise is called after authorization). + // AvsResponseCode: Optional. AVS response code from the gateway + // (available only when reCAPTCHA Enterprise is called after + // authorization). AvsResponseCode string `json:"avsResponseCode,omitempty"` - // CvvResponseCode: CVV response code from the gateway (available only - // when reCAPTCHA Enterprise is called after authorization). + // CvvResponseCode: Optional. CVV response code from the gateway + // (available only when reCAPTCHA Enterprise is called after + // authorization). CvvResponseCode string `json:"cvvResponseCode,omitempty"` - // GatewayResponseCode: Gateway response code describing the state of - // the transaction. + // GatewayResponseCode: Optional. Gateway response code describing the + // state of the transaction. GatewayResponseCode string `json:"gatewayResponseCode,omitempty"` - // Name: Name of the gateway service (for example, stripe, square, - // paypal). + // Name: Optional. Name of the gateway service (for example, stripe, + // square, paypal). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "AvsResponseCode") to @@ -2365,18 +2374,20 @@ func (s *GoogleCloudRecaptchaenterpriseV1TransactionDataGatewayInfo) MarshalJSON // GoogleCloudRecaptchaenterpriseV1TransactionDataItem: Line items being // purchased in this transaction. type GoogleCloudRecaptchaenterpriseV1TransactionDataItem struct { - // MerchantAccountId: When a merchant is specified, its corresponding - // account_id. Necessary to populate marketplace-style transactions. + // MerchantAccountId: Optional. When a merchant is specified, its + // corresponding account_id. Necessary to populate marketplace-style + // transactions. MerchantAccountId string `json:"merchantAccountId,omitempty"` - // Name: The full name of the item. + // Name: Optional. The full name of the item. Name string `json:"name,omitempty"` - // Quantity: The quantity of this item that is being purchased. + // Quantity: Optional. The quantity of this item that is being + // purchased. Quantity int64 `json:"quantity,omitempty,string"` - // Value: The value per item that the user is paying, in the transaction - // currency, after discounts. + // Value: Optional. The value per item that the user is paying, in the + // transaction currency, after discounts. Value float64 `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "MerchantAccountId") @@ -2420,26 +2431,29 @@ func (s *GoogleCloudRecaptchaenterpriseV1TransactionDataItem) UnmarshalJSON(data // GoogleCloudRecaptchaenterpriseV1TransactionDataUser: Details about a // user's account involved in the transaction. type GoogleCloudRecaptchaenterpriseV1TransactionDataUser struct { - // AccountId: Unique account identifier for this user. If using account - // defender, this should match the hashed_account_id field. Otherwise, a - // unique and persistent identifier for this account. + // AccountId: Optional. Unique account identifier for this user. If + // using account defender, this should match the hashed_account_id + // field. Otherwise, a unique and persistent identifier for this + // account. AccountId string `json:"accountId,omitempty"` - // CreationMs: The epoch milliseconds of the user's account creation. + // CreationMs: Optional. The epoch milliseconds of the user's account + // creation. CreationMs int64 `json:"creationMs,omitempty,string"` - // Email: The email address of the user. + // Email: Optional. The email address of the user. Email string `json:"email,omitempty"` - // EmailVerified: Whether the email has been verified to be accessible - // by the user (OTP or similar). + // EmailVerified: Optional. Whether the email has been verified to be + // accessible by the user (OTP or similar). EmailVerified bool `json:"emailVerified,omitempty"` - // PhoneNumber: The phone number of the user, with country code. + // PhoneNumber: Optional. The phone number of the user, with country + // code. PhoneNumber string `json:"phoneNumber,omitempty"` - // PhoneVerified: Whether the phone number has been verified to be - // accessible by the user (OTP or similar). + // PhoneVerified: Optional. Whether the phone number has been verified + // to be accessible by the user (OTP or similar). PhoneVerified bool `json:"phoneVerified,omitempty"` // ForceSendFields is a list of field names (e.g. "AccountId") to @@ -2643,22 +2657,23 @@ func (s *GoogleCloudRecaptchaenterpriseV1WafSettings) MarshalJSON() ([]byte, err // GoogleCloudRecaptchaenterpriseV1WebKeySettings: Settings specific to // keys that can be used by websites. type GoogleCloudRecaptchaenterpriseV1WebKeySettings struct { - // AllowAllDomains: If set to true, it means allowed_domains will not be - // enforced. + // AllowAllDomains: Optional. If set to true, it means allowed_domains + // will not be enforced. AllowAllDomains bool `json:"allowAllDomains,omitempty"` - // AllowAmpTraffic: If set to true, the key can be used on AMP + // AllowAmpTraffic: Optional. If set to true, the key can be used on AMP // (Accelerated Mobile Pages) websites. This is supported only for the // SCORE integration type. AllowAmpTraffic bool `json:"allowAmpTraffic,omitempty"` - // AllowedDomains: Domains or subdomains of websites allowed to use the - // key. All subdomains of an allowed domain are automatically allowed. A - // valid domain requires a host and must not include any path, port, - // query or fragment. Examples: 'example.com' or 'subdomain.example.com' + // AllowedDomains: Optional. Domains or subdomains of websites allowed + // to use the key. All subdomains of an allowed domain are automatically + // allowed. A valid domain requires a host and must not include any + // path, port, query or fragment. Examples: 'example.com' or + // 'subdomain.example.com' AllowedDomains []string `json:"allowedDomains,omitempty"` - // ChallengeSecurityPreference: Settings for the frequency and + // ChallengeSecurityPreference: Optional. Settings for the frequency and // difficulty at which this key triggers captcha challenges. This should // only be specified for IntegrationTypes CHECKBOX and INVISIBLE. // @@ -2781,7 +2796,7 @@ type ProjectsAssessmentsAnnotateCall struct { // authentic or fraudulent. // // - name: The resource name of the Assessment, in the format -// "projects/{project}/assessments/{assessment}". +// `projects/{project}/assessments/{assessment}`. func (r *ProjectsAssessmentsService) Annotate(name string, googlecloudrecaptchaenterprisev1annotateassessmentrequest *GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest) *ProjectsAssessmentsAnnotateCall { c := &ProjectsAssessmentsAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -2892,7 +2907,7 @@ func (c *ProjectsAssessmentsAnnotateCall) Do(opts ...googleapi.CallOption) (*Goo // ], // "parameters": { // "name": { - // "description": "Required. The resource name of the Assessment, in the format \"projects/{project}/assessments/{assessment}\".", + // "description": "Required. The resource name of the Assessment, in the format `projects/{project}/assessments/{assessment}`.", // "location": "path", // "pattern": "^projects/[^/]+/assessments/[^/]+$", // "required": true, @@ -2928,7 +2943,7 @@ type ProjectsAssessmentsCreateCall struct { // legitimate. // // - parent: The name of the project in which the assessment will be -// created, in the format "projects/{project}". +// created, in the format `projects/{project}`. func (r *ProjectsAssessmentsService) Create(parent string, googlecloudrecaptchaenterprisev1assessment *GoogleCloudRecaptchaenterpriseV1Assessment) *ProjectsAssessmentsCreateCall { c := &ProjectsAssessmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3038,7 +3053,7 @@ func (c *ProjectsAssessmentsCreateCall) Do(opts ...googleapi.CallOption) (*Googl // ], // "parameters": { // "parent": { - // "description": "Required. The name of the project in which the assessment will be created, in the format \"projects/{project}\".", + // "description": "Required. The name of the project in which the assessment will be created, in the format `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, @@ -3075,7 +3090,7 @@ type ProjectsFirewallpoliciesCreateCall struct { // maximum of 1000 policies. // // - parent: The name of the project this policy will apply to, in the -// format "projects/{project}". +// format `projects/{project}`. func (r *ProjectsFirewallpoliciesService) Create(parent string, googlecloudrecaptchaenterprisev1firewallpolicy *GoogleCloudRecaptchaenterpriseV1FirewallPolicy) *ProjectsFirewallpoliciesCreateCall { c := &ProjectsFirewallpoliciesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3185,7 +3200,7 @@ func (c *ProjectsFirewallpoliciesCreateCall) Do(opts ...googleapi.CallOption) (* // ], // "parameters": { // "parent": { - // "description": "Required. The name of the project this policy will apply to, in the format \"projects/{project}\".", + // "description": "Required. The name of the project this policy will apply to, in the format `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, @@ -3219,7 +3234,7 @@ type ProjectsFirewallpoliciesDeleteCall struct { // Delete: Deletes the specified firewall policy. // // - name: The name of the policy to be deleted, in the format -// "projects/{project}/firewallpolicies/{firewallpolicy}". +// `projects/{project}/firewallpolicies/{firewallpolicy}`. func (r *ProjectsFirewallpoliciesService) Delete(name string) *ProjectsFirewallpoliciesDeleteCall { c := &ProjectsFirewallpoliciesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3321,7 +3336,7 @@ func (c *ProjectsFirewallpoliciesDeleteCall) Do(opts ...googleapi.CallOption) (* // ], // "parameters": { // "name": { - // "description": "Required. The name of the policy to be deleted, in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + // "description": "Required. The name of the policy to be deleted, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", // "location": "path", // "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", // "required": true, @@ -3353,7 +3368,7 @@ type ProjectsFirewallpoliciesGetCall struct { // Get: Returns the specified firewall policy. // // - name: The name of the requested policy, in the format -// "projects/{project}/firewallpolicies/{firewallpolicy}". +// `projects/{project}/firewallpolicies/{firewallpolicy}`. func (r *ProjectsFirewallpoliciesService) Get(name string) *ProjectsFirewallpoliciesGetCall { c := &ProjectsFirewallpoliciesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3470,7 +3485,7 @@ func (c *ProjectsFirewallpoliciesGetCall) Do(opts ...googleapi.CallOption) (*Goo // ], // "parameters": { // "name": { - // "description": "Required. The name of the requested policy, in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + // "description": "Required. The name of the requested policy, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", // "location": "path", // "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", // "required": true, @@ -3503,7 +3518,7 @@ type ProjectsFirewallpoliciesListCall struct { // project. // // - parent: The name of the project to list the policies for, in the -// format "projects/{project}". +// format `projects/{project}`. func (r *ProjectsFirewallpoliciesService) List(parent string) *ProjectsFirewallpoliciesListCall { c := &ProjectsFirewallpoliciesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3647,7 +3662,7 @@ func (c *ProjectsFirewallpoliciesListCall) Do(opts ...googleapi.CallOption) (*Go // "type": "string" // }, // "parent": { - // "description": "Required. The name of the project to list the policies for, in the format \"projects/{project}\".", + // "description": "Required. The name of the project to list the policies for, in the format `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, @@ -3700,7 +3715,7 @@ type ProjectsFirewallpoliciesPatchCall struct { // Patch: Updates the specified firewall policy. // // - name: The resource name for the FirewallPolicy in the format -// "projects/{project}/firewallpolicies/{firewallpolicy}". +// `projects/{project}/firewallpolicies/{firewallpolicy}`. func (r *ProjectsFirewallpoliciesService) Patch(name string, googlecloudrecaptchaenterprisev1firewallpolicy *GoogleCloudRecaptchaenterpriseV1FirewallPolicy) *ProjectsFirewallpoliciesPatchCall { c := &ProjectsFirewallpoliciesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3818,7 +3833,7 @@ func (c *ProjectsFirewallpoliciesPatchCall) Do(opts ...googleapi.CallOption) (*G // ], // "parameters": { // "name": { - // "description": "The resource name for the FirewallPolicy in the format \"projects/{project}/firewallpolicies/{firewallpolicy}\".", + // "description": "The resource name for the FirewallPolicy in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", // "location": "path", // "pattern": "^projects/[^/]+/firewallpolicies/[^/]+$", // "required": true, @@ -3859,7 +3874,7 @@ type ProjectsKeysCreateCall struct { // Create: Creates a new reCAPTCHA Enterprise key. // // - parent: The name of the project in which the key will be created, -// in the format "projects/{project}". +// in the format `projects/{project}`. func (r *ProjectsKeysService) Create(parent string, googlecloudrecaptchaenterprisev1key *GoogleCloudRecaptchaenterpriseV1Key) *ProjectsKeysCreateCall { c := &ProjectsKeysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3968,7 +3983,7 @@ func (c *ProjectsKeysCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudR // ], // "parameters": { // "parent": { - // "description": "Required. The name of the project in which the key will be created, in the format \"projects/{project}\".", + // "description": "Required. The name of the project in which the key will be created, in the format `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, @@ -4002,7 +4017,7 @@ type ProjectsKeysDeleteCall struct { // Delete: Deletes the specified key. // // - name: The name of the key to be deleted, in the format -// "projects/{project}/keys/{key}". +// `projects/{project}/keys/{key}`. func (r *ProjectsKeysService) Delete(name string) *ProjectsKeysDeleteCall { c := &ProjectsKeysDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4104,7 +4119,7 @@ func (c *ProjectsKeysDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtob // ], // "parameters": { // "name": { - // "description": "Required. The name of the key to be deleted, in the format \"projects/{project}/keys/{key}\".", + // "description": "Required. The name of the key to be deleted, in the format `projects/{project}/keys/{key}`.", // "location": "path", // "pattern": "^projects/[^/]+/keys/[^/]+$", // "required": true, @@ -4136,7 +4151,7 @@ type ProjectsKeysGetCall struct { // Get: Returns the specified key. // // - name: The name of the requested key, in the format -// "projects/{project}/keys/{key}". +// `projects/{project}/keys/{key}`. func (r *ProjectsKeysService) Get(name string) *ProjectsKeysGetCall { c := &ProjectsKeysGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4252,7 +4267,7 @@ func (c *ProjectsKeysGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudReca // ], // "parameters": { // "name": { - // "description": "Required. The name of the requested key, in the format \"projects/{project}/keys/{key}\".", + // "description": "Required. The name of the requested key, in the format `projects/{project}/keys/{key}`.", // "location": "path", // "pattern": "^projects/[^/]+/keys/[^/]+$", // "required": true, @@ -4285,7 +4300,7 @@ type ProjectsKeysGetMetricsCall struct { // used to build dashboards. // // - name: The name of the requested metrics, in the format -// "projects/{project}/keys/{key}/metrics". +// `projects/{project}/keys/{key}/metrics`. func (r *ProjectsKeysService) GetMetrics(name string) *ProjectsKeysGetMetricsCall { c := &ProjectsKeysGetMetricsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4401,7 +4416,7 @@ func (c *ProjectsKeysGetMetricsCall) Do(opts ...googleapi.CallOption) (*GoogleCl // ], // "parameters": { // "name": { - // "description": "Required. The name of the requested metrics, in the format \"projects/{project}/keys/{key}/metrics\".", + // "description": "Required. The name of the requested metrics, in the format `projects/{project}/keys/{key}/metrics`.", // "location": "path", // "pattern": "^projects/[^/]+/keys/[^/]+/metrics$", // "required": true, @@ -4433,7 +4448,7 @@ type ProjectsKeysListCall struct { // List: Returns the list of all keys that belong to a project. // // - parent: The name of the project that contains the keys that will be -// listed, in the format "projects/{project}". +// listed, in the format `projects/{project}`. func (r *ProjectsKeysService) List(parent string) *ProjectsKeysListCall { c := &ProjectsKeysListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4576,7 +4591,7 @@ func (c *ProjectsKeysListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRec // "type": "string" // }, // "parent": { - // "description": "Required. The name of the project that contains the keys that will be listed, in the format \"projects/{project}\".", + // "description": "Required. The name of the project that contains the keys that will be listed, in the format `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, @@ -4634,7 +4649,7 @@ type ProjectsKeysMigrateCall struct { // IAM role in the destination project. // // - name: The name of the key to be migrated, in the format -// "projects/{project}/keys/{key}". +// `projects/{project}/keys/{key}`. func (r *ProjectsKeysService) Migrate(name string, googlecloudrecaptchaenterprisev1migratekeyrequest *GoogleCloudRecaptchaenterpriseV1MigrateKeyRequest) *ProjectsKeysMigrateCall { c := &ProjectsKeysMigrateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4743,7 +4758,7 @@ func (c *ProjectsKeysMigrateCall) Do(opts ...googleapi.CallOption) (*GoogleCloud // ], // "parameters": { // "name": { - // "description": "Required. The name of the key to be migrated, in the format \"projects/{project}/keys/{key}\".", + // "description": "Required. The name of the key to be migrated, in the format `projects/{project}/keys/{key}`.", // "location": "path", // "pattern": "^projects/[^/]+/keys/[^/]+$", // "required": true, @@ -4778,7 +4793,7 @@ type ProjectsKeysPatchCall struct { // Patch: Updates the specified key. // // - name: The resource name for the Key in the format -// "projects/{project}/keys/{key}". +// `projects/{project}/keys/{key}`. func (r *ProjectsKeysService) Patch(name string, googlecloudrecaptchaenterprisev1key *GoogleCloudRecaptchaenterpriseV1Key) *ProjectsKeysPatchCall { c := &ProjectsKeysPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4895,7 +4910,7 @@ func (c *ProjectsKeysPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRe // ], // "parameters": { // "name": { - // "description": "The resource name for the Key in the format \"projects/{project}/keys/{key}\".", + // "description": "The resource name for the Key in the format `projects/{project}/keys/{key}`.", // "location": "path", // "pattern": "^projects/[^/]+/keys/[^/]+$", // "required": true, @@ -4938,7 +4953,7 @@ type ProjectsKeysRetrieveLegacySecretKeyCall struct { // 3rd party integration with legacy reCAPTCHA. // // - key: The public key name linked to the requested secret key in the -// format "projects/{project}/keys/{key}". +// format `projects/{project}/keys/{key}`. func (r *ProjectsKeysService) RetrieveLegacySecretKey(key string) *ProjectsKeysRetrieveLegacySecretKeyCall { c := &ProjectsKeysRetrieveLegacySecretKeyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.key = key @@ -5056,7 +5071,7 @@ func (c *ProjectsKeysRetrieveLegacySecretKeyCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "key": { - // "description": "Required. The public key name linked to the requested secret key in the format \"projects/{project}/keys/{key}\".", + // "description": "Required. The public key name linked to the requested secret key in the format `projects/{project}/keys/{key}`.", // "location": "path", // "pattern": "^projects/[^/]+/keys/[^/]+$", // "required": true, @@ -5089,7 +5104,7 @@ type ProjectsRelatedaccountgroupmembershipsSearchCall struct { // // - project: The name of the project to search related account group // memberships from. Specify the project name in the following format: -// "projects/{project}". +// `projects/{project}`. func (r *ProjectsRelatedaccountgroupmembershipsService) Search(project string, googlecloudrecaptchaenterprisev1searchrelatedaccountgroupmembershipsrequest *GoogleCloudRecaptchaenterpriseV1SearchRelatedAccountGroupMembershipsRequest) *ProjectsRelatedaccountgroupmembershipsSearchCall { c := &ProjectsRelatedaccountgroupmembershipsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project @@ -5200,7 +5215,7 @@ func (c *ProjectsRelatedaccountgroupmembershipsSearchCall) Do(opts ...googleapi. // ], // "parameters": { // "project": { - // "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: \"projects/{project}\".", + // "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, @@ -5258,7 +5273,7 @@ type ProjectsRelatedaccountgroupsListCall struct { // List: List groups of related accounts. // // - parent: The name of the project to list related account groups -// from, in the format "projects/{project}". +// from, in the format `projects/{project}`. func (r *ProjectsRelatedaccountgroupsService) List(parent string) *ProjectsRelatedaccountgroupsListCall { c := &ProjectsRelatedaccountgroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5406,7 +5421,7 @@ func (c *ProjectsRelatedaccountgroupsListCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "parent": { - // "description": "Required. The name of the project to list related account groups from, in the format \"projects/{project}\".", + // "description": "Required. The name of the project to list related account groups from, in the format `projects/{project}`.", // "location": "path", // "pattern": "^projects/[^/]+$", // "required": true, diff --git a/recommender/v1beta1/recommender-api.json b/recommender/v1beta1/recommender-api.json index 6a4a61873ed..4153ea30b12 100644 --- a/recommender/v1beta1/recommender-api.json +++ b/recommender/v1beta1/recommender-api.json @@ -1748,7 +1748,7 @@ } } }, - "revision": "20230910", + "revision": "20231008", "rootUrl": "https://recommender.googleapis.com/", "schemas": { "GoogleCloudRecommenderV1beta1CostProjection": { @@ -1759,6 +1759,10 @@ "$ref": "GoogleTypeMoney", "description": "An approximate projection on amount saved or amount incurred. Negative cost units indicate cost savings and positive cost units indicate increase. See google.type.Money documentation for positive/negative units. A user's permissions may affect whether the cost is computed using list prices or custom contract prices." }, + "costInLocalCurrency": { + "$ref": "GoogleTypeMoney", + "description": "The approximate cost savings in the billing account's local currency." + }, "duration": { "description": "Duration for which this cost applies.", "format": "google-duration", @@ -2309,6 +2313,13 @@ "$ref": "GoogleCloudRecommenderV1beta1RecommendationStateInfo", "description": "Information for state. Contains state and metadata." }, + "targetResources": { + "description": "Fully qualified resource names that this recommendation is targeting.", + "items": { + "type": "string" + }, + "type": "array" + }, "xorGroupId": { "description": "Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.", "type": "string" diff --git a/recommender/v1beta1/recommender-gen.go b/recommender/v1beta1/recommender-gen.go index 4efa4b410a1..db3120f5f87 100644 --- a/recommender/v1beta1/recommender-gen.go +++ b/recommender/v1beta1/recommender-gen.go @@ -470,6 +470,10 @@ type GoogleCloudRecommenderV1beta1CostProjection struct { // cost is computed using list prices or custom contract prices. Cost *GoogleTypeMoney `json:"cost,omitempty"` + // CostInLocalCurrency: The approximate cost savings in the billing + // account's local currency. + CostInLocalCurrency *GoogleTypeMoney `json:"costInLocalCurrency,omitempty"` + // Duration: Duration for which this cost applies. Duration string `json:"duration,omitempty"` @@ -1354,6 +1358,10 @@ type GoogleCloudRecommenderV1beta1Recommendation struct { // StateInfo: Information for state. Contains state and metadata. StateInfo *GoogleCloudRecommenderV1beta1RecommendationStateInfo `json:"stateInfo,omitempty"` + // TargetResources: Fully qualified resource names that this + // recommendation is targeting. + TargetResources []string `json:"targetResources,omitempty"` + // XorGroupId: Corresponds to a mutually exclusive group ID within a // recommender. A non-empty ID indicates that the recommendation belongs // to a mutually exclusive group. This means that only one diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index b6b167c6b60..871d0ff0e57 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -135,6 +135,31 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getLoggingConfig": { + "description": "Gets the LoggingConfig of the requested project.", + "flatPath": "v2alpha/projects/{projectsId}/loggingConfig", + "httpMethod": "GET", + "id": "retail.projects.getLoggingConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full LoggingConfig resource name. Format: projects/{project_number}/loggingConfig", + "location": "path", + "pattern": "^projects/[^/]+/loggingConfig$", + "required": true, + "type": "string" + } + }, + "path": "v2alpha/{+name}", + "response": { + "$ref": "GoogleCloudRetailV2alphaLoggingConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "getRetailProject": { "description": "Gets the project. Throws `NOT_FOUND` if the project wasn't initialized for the Retail API service.", "flatPath": "v2alpha/projects/{projectsId}/retailProject", @@ -184,6 +209,40 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "updateLoggingConfig": { + "description": "Updates the LoggingConfig of the requested project.", + "flatPath": "v2alpha/projects/{projectsId}/loggingConfig", + "httpMethod": "PATCH", + "id": "retail.projects.updateLoggingConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Immutable. The name of the LoggingConfig singleton resource. Format: projects/*/loggingConfig", + "location": "path", + "pattern": "^projects/[^/]+/loggingConfig$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates which fields in the provided LoggingConfig to update. The following are the only supported fields: * default_log_generation_rule * per_service_log_generation_rules If not set, all supported fields are updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2alpha/{+name}", + "request": { + "$ref": "GoogleCloudRetailV2alphaLoggingConfig" + }, + "response": { + "$ref": "GoogleCloudRetailV2alphaLoggingConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -2329,7 +2388,7 @@ } } }, - "revision": "20230906", + "revision": "20231005", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4399,6 +4458,73 @@ }, "type": "object" }, + "GoogleCloudRetailV2alphaLoggingConfig": { + "description": "Project level logging config to control what level of log will be generated and written to Cloud Logging.", + "id": "GoogleCloudRetailV2alphaLoggingConfig", + "properties": { + "defaultLogGenerationRule": { + "$ref": "GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule", + "description": "The log generation rule that applies by default to all services supporting log generation. It can be overridden by ServiceLogGenerationRule for service level control." + }, + "name": { + "description": "Required. Immutable. The name of the LoggingConfig singleton resource. Format: projects/*/loggingConfig", + "type": "string" + }, + "serviceLogGenerationRules": { + "description": "Controls logging configurations more granularly for each supported service. This overrides the default_log_generation_rule for the services specified. For those not mentioned, they will fallback to the default log generation rule.", + "items": { + "$ref": "GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule": { + "description": "The logging configurations for services supporting log generation.", + "id": "GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule", + "properties": { + "infoLogSampleRate": { + "description": "The log sample rate for INFO level log entries. You can use this to reduce the number of entries generated for INFO level logs. DO NOT set this field if the logging_level is not LoggingLevel.LOG_ALL. Otherwise, an INVALID_ARGUMENT error is returned. Sample rate for INFO logs defaults to 1 when unset (generate and send all INFO logs to Cloud Logging). Its value must be greater than 0 and less than or equal to 1.", + "format": "float", + "type": "number" + }, + "loggingLevel": { + "description": "The logging level. By default it is set to `LOG_WARNINGS_AND_ABOVE`.", + "enum": [ + "LOGGING_LEVEL_UNSPECIFIED", + "LOGGING_DISABLED", + "LOG_ERRORS_AND_ABOVE", + "LOG_WARNINGS_AND_ABOVE", + "LOG_ALL" + ], + "enumDescriptions": [ + "Default value. Defaults to `LOG_FOR_WARNINGS_AND_ABOVE` if unset.", + "No log will be generated and sent to Cloud Logging.", + "Log for operations resulted in fatal error.", + "In addition to `LOG_ERRORS_AND_ABOVE`, also log for operations that have soft errors, quality suggestions.", + "Log all operations, including successful ones." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule": { + "description": "The granular logging configurations for supported services.", + "id": "GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule", + "properties": { + "logGenerationRule": { + "$ref": "GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule", + "description": "The log generation rule that applies to this service." + }, + "serviceName": { + "description": "Required. Supported service names: \"CatalogService\", \"CompletionService\", \"ControlService\", \"MerchantCenterStreaming\", \"ModelService\", \"PredictionService\", \"ProductService\", \"ServingConfigService\", \"UserEventService\",", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 989a53f53ed..56ec9f165f9 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -4255,6 +4255,156 @@ func (s *GoogleCloudRetailV2alphaLocalInventory) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2alphaLoggingConfig: Project level logging config +// to control what level of log will be generated and written to Cloud +// Logging. +type GoogleCloudRetailV2alphaLoggingConfig struct { + // DefaultLogGenerationRule: The log generation rule that applies by + // default to all services supporting log generation. It can be + // overridden by ServiceLogGenerationRule for service level control. + DefaultLogGenerationRule *GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule `json:"defaultLogGenerationRule,omitempty"` + + // Name: Required. Immutable. The name of the LoggingConfig singleton + // resource. Format: projects/*/loggingConfig + Name string `json:"name,omitempty"` + + // ServiceLogGenerationRules: Controls logging configurations more + // granularly for each supported service. This overrides the + // default_log_generation_rule for the services specified. For those not + // mentioned, they will fallback to the default log generation rule. + ServiceLogGenerationRules []*GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule `json:"serviceLogGenerationRules,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. + // "DefaultLogGenerationRule") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DefaultLogGenerationRule") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRetailV2alphaLoggingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaLoggingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule: The logging +// configurations for services supporting log generation. +type GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule struct { + // InfoLogSampleRate: The log sample rate for INFO level log entries. + // You can use this to reduce the number of entries generated for INFO + // level logs. DO NOT set this field if the logging_level is not + // LoggingLevel.LOG_ALL. Otherwise, an INVALID_ARGUMENT error is + // returned. Sample rate for INFO logs defaults to 1 when unset + // (generate and send all INFO logs to Cloud Logging). Its value must be + // greater than 0 and less than or equal to 1. + InfoLogSampleRate float64 `json:"infoLogSampleRate,omitempty"` + + // LoggingLevel: The logging level. By default it is set to + // `LOG_WARNINGS_AND_ABOVE`. + // + // Possible values: + // "LOGGING_LEVEL_UNSPECIFIED" - Default value. Defaults to + // `LOG_FOR_WARNINGS_AND_ABOVE` if unset. + // "LOGGING_DISABLED" - No log will be generated and sent to Cloud + // Logging. + // "LOG_ERRORS_AND_ABOVE" - Log for operations resulted in fatal + // error. + // "LOG_WARNINGS_AND_ABOVE" - In addition to `LOG_ERRORS_AND_ABOVE`, + // also log for operations that have soft errors, quality suggestions. + // "LOG_ALL" - Log all operations, including successful ones. + LoggingLevel string `json:"loggingLevel,omitempty"` + + // ForceSendFields is a list of field names (e.g. "InfoLogSampleRate") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "InfoLogSampleRate") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule + var s1 struct { + InfoLogSampleRate gensupport.JSONFloat64 `json:"infoLogSampleRate"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.InfoLogSampleRate = float64(s1.InfoLogSampleRate) + return nil +} + +// GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule: The +// granular logging configurations for supported services. +type GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule struct { + // LogGenerationRule: The log generation rule that applies to this + // service. + LogGenerationRule *GoogleCloudRetailV2alphaLoggingConfigLogGenerationRule `json:"logGenerationRule,omitempty"` + + // ServiceName: Required. Supported service names: "CatalogService", + // "CompletionService", "ControlService", "MerchantCenterStreaming", + // "ModelService", "PredictionService", "ProductService", + // "ServingConfigService", "UserEventService", + ServiceName string `json:"serviceName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LogGenerationRule") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LogGenerationRule") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaLoggingConfigServiceLogGenerationRule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2alphaMerchantCenterAccountLink: Represents a link // between a Merchant Center account and a branch. After a link is // established, products from the linked Merchant Center account are @@ -10379,6 +10529,154 @@ func (c *ProjectsEnrollSolutionCall) Do(opts ...googleapi.CallOption) (*GoogleLo } +// method id "retail.projects.getLoggingConfig": + +type ProjectsGetLoggingConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetLoggingConfig: Gets the LoggingConfig of the requested project. +// +// - name: Full LoggingConfig resource name. Format: +// projects/{project_number}/loggingConfig. +func (r *ProjectsService) GetLoggingConfig(name string) *ProjectsGetLoggingConfigCall { + c := &ProjectsGetLoggingConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsGetLoggingConfigCall) Fields(s ...googleapi.Field) *ProjectsGetLoggingConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsGetLoggingConfigCall) IfNoneMatch(entityTag string) *ProjectsGetLoggingConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsGetLoggingConfigCall) Context(ctx context.Context) *ProjectsGetLoggingConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsGetLoggingConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsGetLoggingConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.getLoggingConfig" call. +// Exactly one of *GoogleCloudRetailV2alphaLoggingConfig or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleCloudRetailV2alphaLoggingConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsGetLoggingConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2alphaLoggingConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRetailV2alphaLoggingConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the LoggingConfig of the requested project.", + // "flatPath": "v2alpha/projects/{projectsId}/loggingConfig", + // "httpMethod": "GET", + // "id": "retail.projects.getLoggingConfig", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Full LoggingConfig resource name. Format: projects/{project_number}/loggingConfig", + // "location": "path", + // "pattern": "^projects/[^/]+/loggingConfig$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2alpha/{+name}", + // "response": { + // "$ref": "GoogleCloudRetailV2alphaLoggingConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.getRetailProject": type ProjectsGetRetailProjectCall struct { @@ -10677,6 +10975,167 @@ func (c *ProjectsListEnrolledSolutionsCall) Do(opts ...googleapi.CallOption) (*G } +// method id "retail.projects.updateLoggingConfig": + +type ProjectsUpdateLoggingConfigCall struct { + s *Service + name string + googlecloudretailv2alphaloggingconfig *GoogleCloudRetailV2alphaLoggingConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateLoggingConfig: Updates the LoggingConfig of the requested +// project. +// +// - name: Immutable. The name of the LoggingConfig singleton resource. +// Format: projects/*/loggingConfig. +func (r *ProjectsService) UpdateLoggingConfig(name string, googlecloudretailv2alphaloggingconfig *GoogleCloudRetailV2alphaLoggingConfig) *ProjectsUpdateLoggingConfigCall { + c := &ProjectsUpdateLoggingConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudretailv2alphaloggingconfig = googlecloudretailv2alphaloggingconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which +// fields in the provided LoggingConfig to update. The following are the +// only supported fields: * default_log_generation_rule * +// per_service_log_generation_rules If not set, all supported fields are +// updated. +func (c *ProjectsUpdateLoggingConfigCall) UpdateMask(updateMask string) *ProjectsUpdateLoggingConfigCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsUpdateLoggingConfigCall) Fields(s ...googleapi.Field) *ProjectsUpdateLoggingConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsUpdateLoggingConfigCall) Context(ctx context.Context) *ProjectsUpdateLoggingConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsUpdateLoggingConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsUpdateLoggingConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2alphaloggingconfig) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.updateLoggingConfig" call. +// Exactly one of *GoogleCloudRetailV2alphaLoggingConfig or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleCloudRetailV2alphaLoggingConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsUpdateLoggingConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2alphaLoggingConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRetailV2alphaLoggingConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the LoggingConfig of the requested project.", + // "flatPath": "v2alpha/projects/{projectsId}/loggingConfig", + // "httpMethod": "PATCH", + // "id": "retail.projects.updateLoggingConfig", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Immutable. The name of the LoggingConfig singleton resource. Format: projects/*/loggingConfig", + // "location": "path", + // "pattern": "^projects/[^/]+/loggingConfig$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Indicates which fields in the provided LoggingConfig to update. The following are the only supported fields: * default_log_generation_rule * per_service_log_generation_rules If not set, all supported fields are updated.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v2alpha/{+name}", + // "request": { + // "$ref": "GoogleCloudRetailV2alphaLoggingConfig" + // }, + // "response": { + // "$ref": "GoogleCloudRetailV2alphaLoggingConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.completeQuery": type ProjectsLocationsCatalogsCompleteQueryCall struct { diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 289a234765c..d4c1cdff325 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -1115,7 +1115,7 @@ } } }, - "revision": "20231001", + "revision": "20231008", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -2286,6 +2286,11 @@ "$ref": "GoogleCloudRunV2RevisionScaling", "description": "Scaling settings for this revision." }, + "scalingStatus": { + "$ref": "GoogleCloudRunV2RevisionScalingStatus", + "description": "Output only. The current effective scaling settings for the revision.", + "readOnly": true + }, "service": { "description": "Output only. The name of the parent service.", "readOnly": true, @@ -2346,6 +2351,18 @@ }, "type": "object" }, + "GoogleCloudRunV2RevisionScalingStatus": { + "description": "Effective settings for the current revision", + "id": "GoogleCloudRunV2RevisionScalingStatus", + "properties": { + "desiredMinInstanceCount": { + "description": "The current number of min instances provisioned for this revision.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "GoogleCloudRunV2RevisionTemplate": { "description": "RevisionTemplate describes the data a revision should have when created from a template.", "id": "GoogleCloudRunV2RevisionTemplate", diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index f86894ede07..b0a1330b630 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -1893,6 +1893,10 @@ type GoogleCloudRunV2Revision struct { // Scaling: Scaling settings for this revision. Scaling *GoogleCloudRunV2RevisionScaling `json:"scaling,omitempty"` + // ScalingStatus: Output only. The current effective scaling settings + // for the revision. + ScalingStatus *GoogleCloudRunV2RevisionScalingStatus `json:"scalingStatus,omitempty"` + // Service: Output only. The name of the parent service. Service string `json:"service,omitempty"` @@ -1986,6 +1990,38 @@ func (s *GoogleCloudRunV2RevisionScaling) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRunV2RevisionScalingStatus: Effective settings for the +// current revision +type GoogleCloudRunV2RevisionScalingStatus struct { + // DesiredMinInstanceCount: The current number of min instances + // provisioned for this revision. + DesiredMinInstanceCount int64 `json:"desiredMinInstanceCount,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "DesiredMinInstanceCount") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DesiredMinInstanceCount") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRunV2RevisionScalingStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRunV2RevisionScalingStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRunV2RevisionTemplate: RevisionTemplate describes the data // a revision should have when created from a template. type GoogleCloudRunV2RevisionTemplate struct {