From d846ea5dd79c01bbf7f2c116fa40b0bdcdc0dc1a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Tue, 13 Jun 2023 00:22:12 -0700 Subject: [PATCH 1/4] feat(all): auto-regenerate discovery clients (#2022) --- adsense/v2/adsense-api.json | 26 +- adsense/v2/adsense-gen.go | 66 +- .../v1alpha/analyticsadmin-api.json | 8 +- analyticsadmin/v1alpha/analyticsadmin-gen.go | 12 +- analyticsadmin/v1beta/analyticsadmin-api.json | 6 +- analyticsadmin/v1beta/analyticsadmin-gen.go | 8 +- androidpublisher/v3/androidpublisher-api.json | 4 +- androidpublisher/v3/androidpublisher-gen.go | 2 +- .../v2/baremetalsolution-api.json | 37 +- baremetalsolution/v2/baremetalsolution-gen.go | 146 +---- chat/v1/chat-api.json | 6 +- chat/v1/chat-gen.go | 12 +- cloudchannel/v1/cloudchannel-api.json | 158 ++++- cloudchannel/v1/cloudchannel-gen.go | 588 ++++++++++++++++++ cloudsearch/v1/cloudsearch-api.json | 23 +- cloudsearch/v1/cloudsearch-gen.go | 47 ++ compute/v0.alpha/compute-api.json | 144 ++++- compute/v0.alpha/compute-gen.go | 224 ++++++- contentwarehouse/v1/contentwarehouse-api.json | 411 ++++++++++-- contentwarehouse/v1/contentwarehouse-gen.go | 438 +++++++++++-- documentai/v1/documentai-api.json | 46 +- documentai/v1/documentai-gen.go | 67 +- documentai/v1beta2/documentai-api.json | 26 +- documentai/v1beta2/documentai-gen.go | 30 +- documentai/v1beta3/documentai-api.json | 76 +-- documentai/v1beta3/documentai-gen.go | 123 ++-- .../v1/serviceconsumermanagement-api.json | 11 +- .../v1/serviceconsumermanagement-gen.go | 7 +- .../serviceconsumermanagement-api.json | 11 +- .../v1beta1/serviceconsumermanagement-gen.go | 7 +- .../v1/servicenetworking-api.json | 11 +- servicenetworking/v1/servicenetworking-gen.go | 7 +- .../v1beta/servicenetworking-api.json | 11 +- .../v1beta/servicenetworking-gen.go | 7 +- serviceusage/v1/serviceusage-api.json | 11 +- serviceusage/v1/serviceusage-gen.go | 7 +- serviceusage/v1beta1/serviceusage-api.json | 11 +- serviceusage/v1beta1/serviceusage-gen.go | 7 +- .../v1/streetviewpublish-api.json | 6 +- streetviewpublish/v1/streetviewpublish-gen.go | 12 +- vision/v1/vision-api.json | 4 +- vision/v1/vision-gen.go | 2 +- vision/v1p1beta1/vision-api.json | 4 +- vision/v1p1beta1/vision-gen.go | 2 +- vision/v1p2beta1/vision-api.json | 4 +- vision/v1p2beta1/vision-gen.go | 2 +- 46 files changed, 2317 insertions(+), 561 deletions(-) diff --git a/adsense/v2/adsense-api.json b/adsense/v2/adsense-api.json index 1e6323b9fae..84da447caf7 100644 --- a/adsense/v2/adsense-api.json +++ b/adsense/v2/adsense-api.json @@ -1061,7 +1061,11 @@ "COST_PER_CLICK", "ADS_PER_IMPRESSION", "TOTAL_EARNINGS", - "WEBSEARCH_RESULT_PAGES" + "WEBSEARCH_RESULT_PAGES", + "FUNNEL_REQUESTS", + "FUNNEL_IMPRESSIONS", + "FUNNEL_CLICKS", + "FUNNEL_RPM" ], "enumDescriptions": [ "Unspecified metric.", @@ -1096,7 +1100,11 @@ "Amount the publisher earns each time a user clicks on an ad. CPC is calculated by dividing the estimated revenue by the number of clicks received.", "Number of ad views per impression.", "Total earnings are the gross estimated earnings from revenue shared traffic before any parent and child account revenue share is applied.", - "Number of results pages." + "Number of results pages.", + "Number of requests for non-ad units (for example a related search unit). For more information, see [Funnel requests](https://support.google.com/adsense/answer/11586959).", + "Number of requests for non-ad units ads that returned content that was shown to the user. For more information, see [Funnel impressions](https://support.google.com/adsense/answer/11585767).", + "Number of times a user clicked on a non-ad unit, triggering further ad requests. For more information, see [Funnel clicks](https://support.google.com/adsense/answer/11586382).", + "Revenue per thousand funnel impressions. This is calculated by dividing estimated revenue by the number of funnel impressions multiplied by 1000. For more information, see [Funnel RPM](https://support.google.com/adsense/answer/11585979)." ], "location": "query", "repeated": true, @@ -1373,7 +1381,11 @@ "COST_PER_CLICK", "ADS_PER_IMPRESSION", "TOTAL_EARNINGS", - "WEBSEARCH_RESULT_PAGES" + "WEBSEARCH_RESULT_PAGES", + "FUNNEL_REQUESTS", + "FUNNEL_IMPRESSIONS", + "FUNNEL_CLICKS", + "FUNNEL_RPM" ], "enumDescriptions": [ "Unspecified metric.", @@ -1408,7 +1420,11 @@ "Amount the publisher earns each time a user clicks on an ad. CPC is calculated by dividing the estimated revenue by the number of clicks received.", "Number of ad views per impression.", "Total earnings are the gross estimated earnings from revenue shared traffic before any parent and child account revenue share is applied.", - "Number of results pages." + "Number of results pages.", + "Number of requests for non-ad units (for example a related search unit). For more information, see [Funnel requests](https://support.google.com/adsense/answer/11586959).", + "Number of requests for non-ad units ads that returned content that was shown to the user. For more information, see [Funnel impressions](https://support.google.com/adsense/answer/11585767).", + "Number of times a user clicked on a non-ad unit, triggering further ad requests. For more information, see [Funnel clicks](https://support.google.com/adsense/answer/11586382).", + "Revenue per thousand funnel impressions. This is calculated by dividing estimated revenue by the number of funnel impressions multiplied by 1000. For more information, see [Funnel RPM](https://support.google.com/adsense/answer/11585979)." ], "location": "query", "repeated": true, @@ -1828,7 +1844,7 @@ } } }, - "revision": "20230531", + "revision": "20230612", "rootUrl": "https://adsense.googleapis.com/", "schemas": { "Account": { diff --git a/adsense/v2/adsense-gen.go b/adsense/v2/adsense-gen.go index 1fcc35092e1..83d089a790f 100644 --- a/adsense/v2/adsense-gen.go +++ b/adsense/v2/adsense-gen.go @@ -5913,6 +5913,27 @@ func (c *AccountsReportsGenerateCall) Limit(limit int64) *AccountsReportsGenerat // revenue share is applied. // // "WEBSEARCH_RESULT_PAGES" - Number of results pages. +// "FUNNEL_REQUESTS" - Number of requests for non-ad units (for +// +// example a related search unit). For more information, see [Funnel +// requests](https://support.google.com/adsense/answer/11586959). +// +// "FUNNEL_IMPRESSIONS" - Number of requests for non-ad units ads that +// +// returned content that was shown to the user. For more information, +// see [Funnel +// impressions](https://support.google.com/adsense/answer/11585767). +// +// "FUNNEL_CLICKS" - Number of times a user clicked on a non-ad unit, +// +// triggering further ad requests. For more information, see [Funnel +// clicks](https://support.google.com/adsense/answer/11586382). +// +// "FUNNEL_RPM" - Revenue per thousand funnel impressions. This is +// +// calculated by dividing estimated revenue by the number of funnel +// impressions multiplied by 1000. For more information, see [Funnel +// RPM](https://support.google.com/adsense/answer/11585979). func (c *AccountsReportsGenerateCall) Metrics(metrics ...string) *AccountsReportsGenerateCall { c.urlParams_.SetMulti("metrics", append([]string{}, metrics...)) return c @@ -6290,7 +6311,11 @@ func (c *AccountsReportsGenerateCall) Do(opts ...googleapi.CallOption) (*ReportR // "COST_PER_CLICK", // "ADS_PER_IMPRESSION", // "TOTAL_EARNINGS", - // "WEBSEARCH_RESULT_PAGES" + // "WEBSEARCH_RESULT_PAGES", + // "FUNNEL_REQUESTS", + // "FUNNEL_IMPRESSIONS", + // "FUNNEL_CLICKS", + // "FUNNEL_RPM" // ], // "enumDescriptions": [ // "Unspecified metric.", @@ -6325,7 +6350,11 @@ func (c *AccountsReportsGenerateCall) Do(opts ...googleapi.CallOption) (*ReportR // "Amount the publisher earns each time a user clicks on an ad. CPC is calculated by dividing the estimated revenue by the number of clicks received.", // "Number of ad views per impression.", // "Total earnings are the gross estimated earnings from revenue shared traffic before any parent and child account revenue share is applied.", - // "Number of results pages." + // "Number of results pages.", + // "Number of requests for non-ad units (for example a related search unit). For more information, see [Funnel requests](https://support.google.com/adsense/answer/11586959).", + // "Number of requests for non-ad units ads that returned content that was shown to the user. For more information, see [Funnel impressions](https://support.google.com/adsense/answer/11585767).", + // "Number of times a user clicked on a non-ad unit, triggering further ad requests. For more information, see [Funnel clicks](https://support.google.com/adsense/answer/11586382).", + // "Revenue per thousand funnel impressions. This is calculated by dividing estimated revenue by the number of funnel impressions multiplied by 1000. For more information, see [Funnel RPM](https://support.google.com/adsense/answer/11585979)." // ], // "location": "query", // "repeated": true, @@ -6821,6 +6850,27 @@ func (c *AccountsReportsGenerateCsvCall) Limit(limit int64) *AccountsReportsGene // revenue share is applied. // // "WEBSEARCH_RESULT_PAGES" - Number of results pages. +// "FUNNEL_REQUESTS" - Number of requests for non-ad units (for +// +// example a related search unit). For more information, see [Funnel +// requests](https://support.google.com/adsense/answer/11586959). +// +// "FUNNEL_IMPRESSIONS" - Number of requests for non-ad units ads that +// +// returned content that was shown to the user. For more information, +// see [Funnel +// impressions](https://support.google.com/adsense/answer/11585767). +// +// "FUNNEL_CLICKS" - Number of times a user clicked on a non-ad unit, +// +// triggering further ad requests. For more information, see [Funnel +// clicks](https://support.google.com/adsense/answer/11586382). +// +// "FUNNEL_RPM" - Revenue per thousand funnel impressions. This is +// +// calculated by dividing estimated revenue by the number of funnel +// impressions multiplied by 1000. For more information, see [Funnel +// RPM](https://support.google.com/adsense/answer/11585979). func (c *AccountsReportsGenerateCsvCall) Metrics(metrics ...string) *AccountsReportsGenerateCsvCall { c.urlParams_.SetMulti("metrics", append([]string{}, metrics...)) return c @@ -7198,7 +7248,11 @@ func (c *AccountsReportsGenerateCsvCall) Do(opts ...googleapi.CallOption) (*Http // "COST_PER_CLICK", // "ADS_PER_IMPRESSION", // "TOTAL_EARNINGS", - // "WEBSEARCH_RESULT_PAGES" + // "WEBSEARCH_RESULT_PAGES", + // "FUNNEL_REQUESTS", + // "FUNNEL_IMPRESSIONS", + // "FUNNEL_CLICKS", + // "FUNNEL_RPM" // ], // "enumDescriptions": [ // "Unspecified metric.", @@ -7233,7 +7287,11 @@ func (c *AccountsReportsGenerateCsvCall) Do(opts ...googleapi.CallOption) (*Http // "Amount the publisher earns each time a user clicks on an ad. CPC is calculated by dividing the estimated revenue by the number of clicks received.", // "Number of ad views per impression.", // "Total earnings are the gross estimated earnings from revenue shared traffic before any parent and child account revenue share is applied.", - // "Number of results pages." + // "Number of results pages.", + // "Number of requests for non-ad units (for example a related search unit). For more information, see [Funnel requests](https://support.google.com/adsense/answer/11586959).", + // "Number of requests for non-ad units ads that returned content that was shown to the user. For more information, see [Funnel impressions](https://support.google.com/adsense/answer/11585767).", + // "Number of times a user clicked on a non-ad unit, triggering further ad requests. For more information, see [Funnel clicks](https://support.google.com/adsense/answer/11586382).", + // "Revenue per thousand funnel impressions. This is calculated by dividing estimated revenue by the number of funnel impressions multiplied by 1000. For more information, see [Funnel RPM](https://support.google.com/adsense/answer/11585979)." // ], // "location": "query", // "repeated": true, diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index aae9019b610..69e8a0e1716 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -4322,7 +4322,7 @@ } } }, - "revision": "20230516", + "revision": "20230612", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { @@ -6319,7 +6319,7 @@ "id": "GoogleAnalyticsAdminV1alphaDataStreamWebStreamData", "properties": { "defaultUri": { - "description": "Immutable. Domain name of the web app being measured, or empty. Example: \"http://www.google.com\", \"https://www.google.com\"", + "description": "Domain name of the web app being measured, or empty. Example: \"http://www.google.com\", \"https://www.google.com\"", "type": "string" }, "firebaseAppId": { @@ -6328,7 +6328,7 @@ "type": "string" }, "measurementId": { - "description": "Output only. Analytics \"Measurement ID\", without the \"G-\" prefix. Example: \"G-1A2BCD345E\" would just be \"1A2BCD345E\"", + "description": "Output only. Analytics Measurement ID. Example: \"G-1A2BCD345E\"", "readOnly": true, "type": "string" } @@ -6448,7 +6448,7 @@ "type": "object" }, "GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings": { - "description": "Singleton resource under a WebDataStream, configuring measurement of additional site interactions and content.", + "description": "Singleton resource under a web DataStream, configuring measurement of additional site interactions and content.", "id": "GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings", "properties": { "fileDownloadsEnabled": { diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index 1d78c696556..ce306821191 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -3895,8 +3895,8 @@ func (s *GoogleAnalyticsAdminV1alphaDataStreamIosAppStreamData) MarshalJSON() ([ // GoogleAnalyticsAdminV1alphaDataStreamWebStreamData: Data specific to // web streams. type GoogleAnalyticsAdminV1alphaDataStreamWebStreamData struct { - // DefaultUri: Immutable. Domain name of the web app being measured, or - // empty. Example: "http://www.google.com", "https://www.google.com" + // DefaultUri: Domain name of the web app being measured, or empty. + // Example: "http://www.google.com", "https://www.google.com" DefaultUri string `json:"defaultUri,omitempty"` // FirebaseAppId: Output only. ID of the corresponding web app in @@ -3904,8 +3904,8 @@ type GoogleAnalyticsAdminV1alphaDataStreamWebStreamData struct { // recreated. FirebaseAppId string `json:"firebaseAppId,omitempty"` - // MeasurementId: Output only. Analytics "Measurement ID", without the - // "G-" prefix. Example: "G-1A2BCD345E" would just be "1A2BCD345E" + // MeasurementId: Output only. Analytics Measurement ID. Example: + // "G-1A2BCD345E" MeasurementId string `json:"measurementId,omitempty"` // ForceSendFields is a list of field names (e.g. "DefaultUri") to @@ -4173,8 +4173,8 @@ func (s *GoogleAnalyticsAdminV1alphaDisplayVideo360AdvertiserLinkProposal) Marsh } // GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings: Singleton -// resource under a WebDataStream, configuring measurement of additional -// site interactions and content. +// resource under a web DataStream, configuring measurement of +// additional site interactions and content. type GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings struct { // FileDownloadsEnabled: If enabled, capture a file download event each // time a link is clicked with a common document, compressed file, diff --git a/analyticsadmin/v1beta/analyticsadmin-api.json b/analyticsadmin/v1beta/analyticsadmin-api.json index c62acd2119d..940dfc4f8f9 100644 --- a/analyticsadmin/v1beta/analyticsadmin-api.json +++ b/analyticsadmin/v1beta/analyticsadmin-api.json @@ -1594,7 +1594,7 @@ } } }, - "revision": "20230410", + "revision": "20230612", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1betaAccessBetweenFilter": { @@ -2498,7 +2498,7 @@ "id": "GoogleAnalyticsAdminV1betaDataStreamWebStreamData", "properties": { "defaultUri": { - "description": "Immutable. Domain name of the web app being measured, or empty. Example: \"http://www.google.com\", \"https://www.google.com\"", + "description": "Domain name of the web app being measured, or empty. Example: \"http://www.google.com\", \"https://www.google.com\"", "type": "string" }, "firebaseAppId": { @@ -2507,7 +2507,7 @@ "type": "string" }, "measurementId": { - "description": "Output only. Analytics \"Measurement ID\", without the \"G-\" prefix. Example: \"G-1A2BCD345E\" would just be \"1A2BCD345E\"", + "description": "Output only. Analytics Measurement ID. Example: \"G-1A2BCD345E\"", "readOnly": true, "type": "string" } diff --git a/analyticsadmin/v1beta/analyticsadmin-gen.go b/analyticsadmin/v1beta/analyticsadmin-gen.go index f5b7b94a75a..bbb8af6d0f4 100644 --- a/analyticsadmin/v1beta/analyticsadmin-gen.go +++ b/analyticsadmin/v1beta/analyticsadmin-gen.go @@ -1764,8 +1764,8 @@ func (s *GoogleAnalyticsAdminV1betaDataStreamIosAppStreamData) MarshalJSON() ([] // GoogleAnalyticsAdminV1betaDataStreamWebStreamData: Data specific to // web streams. type GoogleAnalyticsAdminV1betaDataStreamWebStreamData struct { - // DefaultUri: Immutable. Domain name of the web app being measured, or - // empty. Example: "http://www.google.com", "https://www.google.com" + // DefaultUri: Domain name of the web app being measured, or empty. + // Example: "http://www.google.com", "https://www.google.com" DefaultUri string `json:"defaultUri,omitempty"` // FirebaseAppId: Output only. ID of the corresponding web app in @@ -1773,8 +1773,8 @@ type GoogleAnalyticsAdminV1betaDataStreamWebStreamData struct { // recreated. FirebaseAppId string `json:"firebaseAppId,omitempty"` - // MeasurementId: Output only. Analytics "Measurement ID", without the - // "G-" prefix. Example: "G-1A2BCD345E" would just be "1A2BCD345E" + // MeasurementId: Output only. Analytics Measurement ID. Example: + // "G-1A2BCD345E" MeasurementId string `json:"measurementId,omitempty"` // ForceSendFields is a list of field names (e.g. "DefaultUri") to diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index 7ca219db2dd..0b5029fbbf7 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -632,7 +632,7 @@ "accept": [ "application/octet-stream" ], - "maxSize": "838860800", + "maxSize": "1258291200", "protocols": { "resumable": { "multipart": true, @@ -4047,7 +4047,7 @@ } } }, - "revision": "20230608", + "revision": "20230612", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "AcquisitionTargetingRule": { diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 7d93f6ad109..22ef03e25d3 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -8921,7 +8921,7 @@ func (c *EditsDeobfuscationfilesUploadCall) Do(opts ...googleapi.CallOption) (*D // "accept": [ // "application/octet-stream" // ], - // "maxSize": "838860800", + // "maxSize": "1258291200", // "protocols": { // "resumable": { // "multipart": true, diff --git a/baremetalsolution/v2/baremetalsolution-api.json b/baremetalsolution/v2/baremetalsolution-api.json index 60662af1a2a..3c2bbc073f4 100644 --- a/baremetalsolution/v2/baremetalsolution-api.json +++ b/baremetalsolution/v2/baremetalsolution-api.json @@ -207,34 +207,6 @@ }, "instances": { "methods": { - "create": { - "description": "Create an Instance.", - "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances", - "httpMethod": "POST", - "id": "baremetalsolution.projects.locations.instances.create", - "parameterOrder": [ - "parent" - ], - "parameters": { - "parent": { - "description": "Required. The parent project and location.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+parent}/instances", - "request": { - "$ref": "Instance" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "detachLun": { "description": "Detach LUN from Instance.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:detachLun", @@ -1605,7 +1577,7 @@ } } }, - "revision": "20230522", + "revision": "20230607", "rootUrl": "https://baremetalsolution.googleapis.com/", "schemas": { "AllowedClient": { @@ -1970,6 +1942,13 @@ "$ref": "NetworkAddress", "description": "Private network address, if any. Filled if InstanceConfig.multivlan_config is false." }, + "sshKeyNames": { + "description": "List of names of ssh keys used to provision the instance.", + "items": { + "type": "string" + }, + "type": "array" + }, "userNote": { "description": "User note field, it can be used by customers to add additional information for the BMS Ops team .", "type": "string" diff --git a/baremetalsolution/v2/baremetalsolution-gen.go b/baremetalsolution/v2/baremetalsolution-gen.go index b2f06796c63..238ab001620 100644 --- a/baremetalsolution/v2/baremetalsolution-gen.go +++ b/baremetalsolution/v2/baremetalsolution-gen.go @@ -707,6 +707,10 @@ type InstanceConfig struct { // InstanceConfig.multivlan_config is false. PrivateNetwork *NetworkAddress `json:"privateNetwork,omitempty"` + // SshKeyNames: List of names of ssh keys used to provision the + // instance. + SshKeyNames []string `json:"sshKeyNames,omitempty"` + // UserNote: User note field, it can be used by customers to add // additional information for the BMS Ops team . UserNote string `json:"userNote,omitempty"` @@ -3481,148 +3485,6 @@ func (c *ProjectsLocationsInstanceProvisioningSettingsFetchCall) Do(opts ...goog } -// method id "baremetalsolution.projects.locations.instances.create": - -type ProjectsLocationsInstancesCreateCall struct { - s *Service - parent string - instance *Instance - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Create: Create an Instance. -// -// - parent: The parent project and location. -func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall { - c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.instance = instance - 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 *ProjectsLocationsInstancesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesCreateCall { - 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 *ProjectsLocationsInstancesCreateCall) Context(ctx context.Context) *ProjectsLocationsInstancesCreateCall { - 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 *ProjectsLocationsInstancesCreateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInstancesCreateCall) 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.instance) - 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/{+parent}/instances") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", 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 "baremetalsolution.projects.locations.instances.create" 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 *ProjectsLocationsInstancesCreateCall) 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": "Create an Instance.", - // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances", - // "httpMethod": "POST", - // "id": "baremetalsolution.projects.locations.instances.create", - // "parameterOrder": [ - // "parent" - // ], - // "parameters": { - // "parent": { - // "description": "Required. The parent project and location.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v2/{+parent}/instances", - // "request": { - // "$ref": "Instance" - // }, - // "response": { - // "$ref": "Operation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - // method id "baremetalsolution.projects.locations.instances.detachLun": type ProjectsLocationsInstancesDetachLunCall struct { diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index ac394093da7..cf625dccbb1 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -480,7 +480,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name of the membership to retrieve. Format: `spaces/{space}/members/{member}`", + "description": "Required. Resource name of the membership to retrieve. To get the app's own membership, you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`", "location": "path", "pattern": "^spaces/[^/]+/members/[^/]+$", "required": true, @@ -940,7 +940,7 @@ } } }, - "revision": "20230606", + "revision": "20230608", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -1454,7 +1454,7 @@ "type": "object" }, "DeprecatedEvent": { - "description": "Google Chat events.", + "description": "Google Chat events. To learn how to use events, see [Receive and respond to Google Chat events](https://developers.google.com/chat/api/guides/message-formats).", "id": "DeprecatedEvent", "properties": { "action": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 945bf967b4e..3bf2e5f9cf6 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -1193,7 +1193,9 @@ func (s *DeletionMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// DeprecatedEvent: Google Chat events. +// DeprecatedEvent: Google Chat events. To learn how to use events, see +// Receive and respond to Google Chat events +// (https://developers.google.com/chat/api/guides/message-formats). type DeprecatedEvent struct { // Action: The form action data associated with an interactive card that // was clicked. Only populated for CARD_CLICKED events. See the @@ -6710,8 +6712,10 @@ type SpacesMembersGetCall struct { // the `chat.memberships` or `chat.memberships.readonly` authorization // scope. // -// - name: Resource name of the membership to retrieve. Format: -// `spaces/{space}/members/{member}`. +// - name: Resource name of the membership to retrieve. To get the app's +// own membership, you can optionally use +// `spaces/{space}/members/app`. Format: +// `spaces/{space}/members/{member}` or `spaces/{space}/members/app`. func (r *SpacesMembersService) Get(name string) *SpacesMembersGetCall { c := &SpacesMembersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6826,7 +6830,7 @@ func (c *SpacesMembersGetCall) Do(opts ...googleapi.CallOption) (*Membership, er // ], // "parameters": { // "name": { - // "description": "Required. Resource name of the membership to retrieve. Format: `spaces/{space}/members/{member}`", + // "description": "Required. Resource name of the membership to retrieve. To get the app's own membership, you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`", // "location": "path", // "pattern": "^spaces/[^/]+/members/[^/]+$", // "required": true, diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index 3965f6cf845..2459a69f244 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -1876,6 +1876,88 @@ ] } } + }, + "skuGroups": { + "methods": { + "list": { + "description": "Lists the Rebilling supported SKU groups the account is authorized to sell. Reference: https://cloud.google.com/skus/sku-groups Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different, or the account doesn't exist. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the SkuGroup resources. The data for each resource is displayed in the alphabetical order of SKU group display name. The data for each resource is displayed in the ascending order of SkuGroup.display_name If unsuccessful, returns an error.", + "flatPath": "v1/accounts/{accountsId}/skuGroups", + "httpMethod": "GET", + "id": "cloudchannel.accounts.skuGroups.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of SKU groups to return. The service may return fewer than this value. If unspecified, returns a maximum of 1000 SKU groups. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroups.next_page_token of the previous CloudChannelService.ListSkuGroups call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name of the account from which to list SKU groups. Parent uses the format: accounts/{account}.", + "location": "path", + "pattern": "^accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/skuGroups", + "response": { + "$ref": "GoogleCloudChannelV1ListSkuGroupsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/apps.order" + ] + } + }, + "resources": { + "billableSkus": { + "methods": { + "list": { + "description": "Lists the Billable SKUs in a given SKU group. Possible error codes: PERMISSION_DENIED: If the account making the request and the account being queried for are different, or the account doesn't exist. INVALID_ARGUMENT: Missing or invalid required parameters in the request. INTERNAL: Any non-user error related to technical issue in the backend. In this case, contact cloud channel support. Return Value: If successful, the BillableSku resources. The data for each resource is displayed in the ascending order of: * BillableSku.service_display_name * BillableSku.sku_display_name If unsuccessful, returns an error.", + "flatPath": "v1/accounts/{accountsId}/skuGroups/{skuGroupsId}/billableSkus", + "httpMethod": "GET", + "id": "cloudchannel.accounts.skuGroups.billableSkus.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of SKUs to return. The service may return fewer than this value. If unspecified, returns a maximum of 100000 SKUs. The maximum value is 100000; values above 100000 will be coerced to 100000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroupBillableSkus.next_page_token of the previous CloudChannelService.ListSkuGroupBillableSkus call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Resource name of the SKU group. Format: accounts/{account}/skuGroups/{sku_group}.", + "location": "path", + "pattern": "^accounts/[^/]+/skuGroups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/billableSkus", + "response": { + "$ref": "GoogleCloudChannelV1ListSkuGroupBillableSkusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/apps.order" + ] + } + } + } + } } } }, @@ -2096,7 +2178,7 @@ } } }, - "revision": "20230516", + "revision": "20230611", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -2140,6 +2222,29 @@ }, "type": "object" }, + "GoogleCloudChannelV1BillableSku": { + "description": "Represents the Billable SKU information.", + "id": "GoogleCloudChannelV1BillableSku", + "properties": { + "service": { + "description": "Resource name of Service which contains Repricing SKU. Format: services/{service}. Example: \"services/B7D9-FDCB-15D8\".", + "type": "string" + }, + "serviceDisplayName": { + "description": "Unique human readable name for the Service.", + "type": "string" + }, + "sku": { + "description": "Resource name of Billable SKU. Format: billableSkus/{sku}. Example: billableSkus/6E1B-6634-470F\".", + "type": "string" + }, + "skuDisplayName": { + "description": "Unique human readable name for the SKU.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudChannelV1BillingAccount": { "description": "Represents a billing account.", "id": "GoogleCloudChannelV1BillingAccount", @@ -3394,6 +3499,42 @@ }, "type": "object" }, + "GoogleCloudChannelV1ListSkuGroupBillableSkusResponse": { + "description": "Response message for ListSkuGroupBillableSkus.", + "id": "GoogleCloudChannelV1ListSkuGroupBillableSkusResponse", + "properties": { + "billableSkus": { + "description": "The list of billable SKUs in the requested SKU group.", + "items": { + "$ref": "GoogleCloudChannelV1BillableSku" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token to retrieve the next page of results. Pass to ListSkuGroupBillableSkus.page_token to obtain that page.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudChannelV1ListSkuGroupsResponse": { + "description": "Response message for ListSkuGroups.", + "id": "GoogleCloudChannelV1ListSkuGroupsResponse", + "properties": { + "nextPageToken": { + "description": "A token to retrieve the next page of results. Pass to ListSkuGroups.page_token to obtain that page.", + "type": "string" + }, + "skuGroups": { + "description": "The list of SKU groups requested.", + "items": { + "$ref": "GoogleCloudChannelV1SkuGroup" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudChannelV1ListSkusResponse": { "description": "Response message for ListSkus.", "id": "GoogleCloudChannelV1ListSkusResponse", @@ -4409,6 +4550,21 @@ }, "type": "object" }, + "GoogleCloudChannelV1SkuGroup": { + "description": "Represents the SKU group information.", + "id": "GoogleCloudChannelV1SkuGroup", + "properties": { + "displayName": { + "description": "Unique human readable identifier for the SKU group.", + "type": "string" + }, + "name": { + "description": "Resource name of SKU group. Format: accounts/{account}/skuGroups/{sku_group}. Example: \"accounts/C01234/skuGroups/3d50fd57-3157-4577-a5a9-a219b8490041\".", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudChannelV1SkuGroupCondition": { "description": "A condition that applies the override if a line item SKU is found in the SKU group.", "id": "GoogleCloudChannelV1SkuGroupCondition", diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index 2c48b44e08e..6f4e69af2fc 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -158,6 +158,7 @@ func NewAccountsService(s *Service) *AccountsService { rs.Offers = NewAccountsOffersService(s) rs.ReportJobs = NewAccountsReportJobsService(s) rs.Reports = NewAccountsReportsService(s) + rs.SkuGroups = NewAccountsSkuGroupsService(s) return rs } @@ -173,6 +174,8 @@ type AccountsService struct { ReportJobs *AccountsReportJobsService Reports *AccountsReportsService + + SkuGroups *AccountsSkuGroupsService } func NewAccountsChannelPartnerLinksService(s *Service) *AccountsChannelPartnerLinksService { @@ -268,6 +271,27 @@ type AccountsReportsService struct { s *Service } +func NewAccountsSkuGroupsService(s *Service) *AccountsSkuGroupsService { + rs := &AccountsSkuGroupsService{s: s} + rs.BillableSkus = NewAccountsSkuGroupsBillableSkusService(s) + return rs +} + +type AccountsSkuGroupsService struct { + s *Service + + BillableSkus *AccountsSkuGroupsBillableSkusService +} + +func NewAccountsSkuGroupsBillableSkusService(s *Service) *AccountsSkuGroupsBillableSkusService { + rs := &AccountsSkuGroupsBillableSkusService{s: s} + return rs +} + +type AccountsSkuGroupsBillableSkusService struct { + s *Service +} + func NewOperationsService(s *Service) *OperationsService { rs := &OperationsService{s: s} return rs @@ -401,6 +425,46 @@ func (s *GoogleCloudChannelV1AssociationInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudChannelV1BillableSku: Represents the Billable SKU +// information. +type GoogleCloudChannelV1BillableSku struct { + // Service: Resource name of Service which contains Repricing SKU. + // Format: services/{service}. Example: "services/B7D9-FDCB-15D8". + Service string `json:"service,omitempty"` + + // ServiceDisplayName: Unique human readable name for the Service. + ServiceDisplayName string `json:"serviceDisplayName,omitempty"` + + // Sku: Resource name of Billable SKU. Format: billableSkus/{sku}. + // Example: billableSkus/6E1B-6634-470F". + Sku string `json:"sku,omitempty"` + + // SkuDisplayName: Unique human readable name for the SKU. + SkuDisplayName string `json:"skuDisplayName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Service") 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. "Service") 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 *GoogleCloudChannelV1BillableSku) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudChannelV1BillableSku + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudChannelV1BillingAccount: Represents a billing account. type GoogleCloudChannelV1BillingAccount struct { // CreateTime: Output only. The time when this billing account was @@ -2393,6 +2457,80 @@ func (s *GoogleCloudChannelV1ListReportsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudChannelV1ListSkuGroupBillableSkusResponse: Response +// message for ListSkuGroupBillableSkus. +type GoogleCloudChannelV1ListSkuGroupBillableSkusResponse struct { + // BillableSkus: The list of billable SKUs in the requested SKU group. + BillableSkus []*GoogleCloudChannelV1BillableSku `json:"billableSkus,omitempty"` + + // NextPageToken: A token to retrieve the next page of results. Pass to + // ListSkuGroupBillableSkus.page_token to obtain that page. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "BillableSkus") 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. "BillableSkus") 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 *GoogleCloudChannelV1ListSkuGroupBillableSkusResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudChannelV1ListSkuGroupBillableSkusResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudChannelV1ListSkuGroupsResponse: Response message for +// ListSkuGroups. +type GoogleCloudChannelV1ListSkuGroupsResponse struct { + // NextPageToken: A token to retrieve the next page of results. Pass to + // ListSkuGroups.page_token to obtain that page. + NextPageToken string `json:"nextPageToken,omitempty"` + + // SkuGroups: The list of SKU groups requested. + SkuGroups []*GoogleCloudChannelV1SkuGroup `json:"skuGroups,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 *GoogleCloudChannelV1ListSkuGroupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudChannelV1ListSkuGroupsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudChannelV1ListSkusResponse: Response message for ListSkus. type GoogleCloudChannelV1ListSkusResponse struct { // NextPageToken: A token to retrieve the next page of results. @@ -4108,6 +4246,39 @@ func (s *GoogleCloudChannelV1Sku) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudChannelV1SkuGroup: Represents the SKU group information. +type GoogleCloudChannelV1SkuGroup struct { + // DisplayName: Unique human readable identifier for the SKU group. + DisplayName string `json:"displayName,omitempty"` + + // Name: Resource name of SKU group. Format: + // accounts/{account}/skuGroups/{sku_group}. Example: + // "accounts/C01234/skuGroups/3d50fd57-3157-4577-a5a9-a219b8490041". + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 *GoogleCloudChannelV1SkuGroup) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudChannelV1SkuGroup + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudChannelV1SkuGroupCondition: A condition that applies the // override if a line item SKU is found in the SKU group. type GoogleCloudChannelV1SkuGroupCondition struct { @@ -15760,6 +15931,423 @@ func (c *AccountsReportsRunCall) Do(opts ...googleapi.CallOption) (*GoogleLongru } +// method id "cloudchannel.accounts.skuGroups.list": + +type AccountsSkuGroupsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the Rebilling supported SKU groups the account is +// authorized to sell. Reference: +// https://cloud.google.com/skus/sku-groups Possible Error Codes: * +// PERMISSION_DENIED: If the account making the request and the account +// being queried are different, or the account doesn't exist. * +// INTERNAL: Any non-user error related to technical issues in the +// backend. In this case, contact Cloud Channel support. Return Value: +// If successful, the SkuGroup resources. The data for each resource is +// displayed in the alphabetical order of SKU group display name. The +// data for each resource is displayed in the ascending order of +// SkuGroup.display_name If unsuccessful, returns an error. +// +// - parent: The resource name of the account from which to list SKU +// groups. Parent uses the format: accounts/{account}. +func (r *AccountsSkuGroupsService) List(parent string) *AccountsSkuGroupsListCall { + c := &AccountsSkuGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of SKU groups to return. The service may return fewer than this +// value. If unspecified, returns a maximum of 1000 SKU groups. The +// maximum value is 1000; values above 1000 will be coerced to 1000. +func (c *AccountsSkuGroupsListCall) PageSize(pageSize int64) *AccountsSkuGroupsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results beyond the first page. Obtained through +// ListSkuGroups.next_page_token of the previous +// CloudChannelService.ListSkuGroups call. +func (c *AccountsSkuGroupsListCall) PageToken(pageToken string) *AccountsSkuGroupsListCall { + 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 *AccountsSkuGroupsListCall) Fields(s ...googleapi.Field) *AccountsSkuGroupsListCall { + 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 *AccountsSkuGroupsListCall) IfNoneMatch(entityTag string) *AccountsSkuGroupsListCall { + 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 *AccountsSkuGroupsListCall) Context(ctx context.Context) *AccountsSkuGroupsListCall { + 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 *AccountsSkuGroupsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsSkuGroupsListCall) 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, "v1/{+parent}/skuGroups") + 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 "cloudchannel.accounts.skuGroups.list" call. +// Exactly one of *GoogleCloudChannelV1ListSkuGroupsResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudChannelV1ListSkuGroupsResponse.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 *AccountsSkuGroupsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1ListSkuGroupsResponse, 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 := &GoogleCloudChannelV1ListSkuGroupsResponse{ + 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 the Rebilling supported SKU groups the account is authorized to sell. Reference: https://cloud.google.com/skus/sku-groups Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different, or the account doesn't exist. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the SkuGroup resources. The data for each resource is displayed in the alphabetical order of SKU group display name. The data for each resource is displayed in the ascending order of SkuGroup.display_name If unsuccessful, returns an error.", + // "flatPath": "v1/accounts/{accountsId}/skuGroups", + // "httpMethod": "GET", + // "id": "cloudchannel.accounts.skuGroups.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of SKU groups to return. The service may return fewer than this value. If unspecified, returns a maximum of 1000 SKU groups. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroups.next_page_token of the previous CloudChannelService.ListSkuGroups call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the account from which to list SKU groups. Parent uses the format: accounts/{account}.", + // "location": "path", + // "pattern": "^accounts/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/skuGroups", + // "response": { + // "$ref": "GoogleCloudChannelV1ListSkuGroupsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/apps.order" + // ] + // } + +} + +// 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 *AccountsSkuGroupsListCall) Pages(ctx context.Context, f func(*GoogleCloudChannelV1ListSkuGroupsResponse) 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 "cloudchannel.accounts.skuGroups.billableSkus.list": + +type AccountsSkuGroupsBillableSkusListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the Billable SKUs in a given SKU group. Possible error +// codes: PERMISSION_DENIED: If the account making the request and the +// account being queried for are different, or the account doesn't +// exist. INVALID_ARGUMENT: Missing or invalid required parameters in +// the request. INTERNAL: Any non-user error related to technical issue +// in the backend. In this case, contact cloud channel support. Return +// Value: If successful, the BillableSku resources. The data for each +// resource is displayed in the ascending order of: * +// BillableSku.service_display_name * BillableSku.sku_display_name If +// unsuccessful, returns an error. +// +// - parent: Resource name of the SKU group. Format: +// accounts/{account}/skuGroups/{sku_group}. +func (r *AccountsSkuGroupsBillableSkusService) List(parent string) *AccountsSkuGroupsBillableSkusListCall { + c := &AccountsSkuGroupsBillableSkusListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of SKUs to return. The service may return fewer than this value. If +// unspecified, returns a maximum of 100000 SKUs. The maximum value is +// 100000; values above 100000 will be coerced to 100000. +func (c *AccountsSkuGroupsBillableSkusListCall) PageSize(pageSize int64) *AccountsSkuGroupsBillableSkusListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results beyond the first page. Obtained through +// ListSkuGroupBillableSkus.next_page_token of the previous +// CloudChannelService.ListSkuGroupBillableSkus call. +func (c *AccountsSkuGroupsBillableSkusListCall) PageToken(pageToken string) *AccountsSkuGroupsBillableSkusListCall { + 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 *AccountsSkuGroupsBillableSkusListCall) Fields(s ...googleapi.Field) *AccountsSkuGroupsBillableSkusListCall { + 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 *AccountsSkuGroupsBillableSkusListCall) IfNoneMatch(entityTag string) *AccountsSkuGroupsBillableSkusListCall { + 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 *AccountsSkuGroupsBillableSkusListCall) Context(ctx context.Context) *AccountsSkuGroupsBillableSkusListCall { + 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 *AccountsSkuGroupsBillableSkusListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsSkuGroupsBillableSkusListCall) 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, "v1/{+parent}/billableSkus") + 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 "cloudchannel.accounts.skuGroups.billableSkus.list" call. +// Exactly one of *GoogleCloudChannelV1ListSkuGroupBillableSkusResponse +// or error will be non-nil. Any non-2xx status code is an error. +// Response headers are in either +// *GoogleCloudChannelV1ListSkuGroupBillableSkusResponse.ServerResponse.H +// eader 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 *AccountsSkuGroupsBillableSkusListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1ListSkuGroupBillableSkusResponse, 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 := &GoogleCloudChannelV1ListSkuGroupBillableSkusResponse{ + 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 the Billable SKUs in a given SKU group. Possible error codes: PERMISSION_DENIED: If the account making the request and the account being queried for are different, or the account doesn't exist. INVALID_ARGUMENT: Missing or invalid required parameters in the request. INTERNAL: Any non-user error related to technical issue in the backend. In this case, contact cloud channel support. Return Value: If successful, the BillableSku resources. The data for each resource is displayed in the ascending order of: * BillableSku.service_display_name * BillableSku.sku_display_name If unsuccessful, returns an error.", + // "flatPath": "v1/accounts/{accountsId}/skuGroups/{skuGroupsId}/billableSkus", + // "httpMethod": "GET", + // "id": "cloudchannel.accounts.skuGroups.billableSkus.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of SKUs to return. The service may return fewer than this value. If unspecified, returns a maximum of 100000 SKUs. The maximum value is 100000; values above 100000 will be coerced to 100000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroupBillableSkus.next_page_token of the previous CloudChannelService.ListSkuGroupBillableSkus call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Resource name of the SKU group. Format: accounts/{account}/skuGroups/{sku_group}.", + // "location": "path", + // "pattern": "^accounts/[^/]+/skuGroups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/billableSkus", + // "response": { + // "$ref": "GoogleCloudChannelV1ListSkuGroupBillableSkusResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/apps.order" + // ] + // } + +} + +// 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 *AccountsSkuGroupsBillableSkusListCall) Pages(ctx context.Context, f func(*GoogleCloudChannelV1ListSkuGroupBillableSkusResponse) 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 "cloudchannel.operations.cancel": type OperationsCancelCall struct { diff --git a/cloudsearch/v1/cloudsearch-api.json b/cloudsearch/v1/cloudsearch-api.json index 2d69ab52fdb..13d13ebb48c 100644 --- a/cloudsearch/v1/cloudsearch-api.json +++ b/cloudsearch/v1/cloudsearch-api.json @@ -2096,7 +2096,7 @@ } } }, - "revision": "20230524", + "revision": "20230531", "rootUrl": "https://cloudsearch.googleapis.com/", "schemas": { "AbuseReportingConfig": { @@ -15852,6 +15852,17 @@ }, "type": "object" }, + "SafeHtmlProto": { + "description": "IMPORTANT: It is unsafe to accept this message from an untrusted source, since it's trivial for an attacker to forge serialized messages that don't fulfill the type's safety contract -- for example, it could contain attacker controlled script. A system which receives a SafeHtmlProto implicitly trusts the producer of the SafeHtmlProto. So, it's generally safe to return this message in RPC responses, but generally unsafe to accept it in RPC requests.", + "id": "SafeHtmlProto", + "properties": { + "privateDoNotAccessOrElseSafeHtmlWrappedValue": { + "description": "IMPORTANT: Never set or read this field, even from tests, it is private. See documentation at the top of .proto file for programming language packages with which to create or read this message.", + "type": "string" + } + }, + "type": "object" + }, "SafeUrlProto": { "description": "Message containing a string that is safe to use in URL contexts in DOM APIs and HTML documents, where the URL context does not refer to a resource that loads code.", "id": "SafeUrlProto", @@ -16969,6 +16980,10 @@ "description": "The suggested spelling of the query.", "type": "string" }, + "suggestedQueryHtml": { + "$ref": "SafeHtmlProto", + "description": "The sanitized HTML representing the spell corrected query that can be used in the UI. This usually has language-specific tags to mark up parts of the query that are spell checked." + }, "suggestionType": { "description": "Suggestion triggered for the current query.", "enum": [ @@ -17824,7 +17839,8 @@ "ACTION_CARIBOU_DATA_RETENTION_DIFF", "ACTION_RELEVANCY_SCORE_BACKFILL", "ACTION_PDH_PUSH_NOTIFICATION_BACKFILL", - "ACTION_AUTO_SAVE_DRAFT_EXPUNGE" + "ACTION_AUTO_SAVE_DRAFT_EXPUNGE", + "ACTION_RELEVANCY_SCORE_CATCHUP" ], "enumDescriptions": [ "", @@ -17863,7 +17879,8 @@ "Trigger for executing comparison logic between the output of ApplyDataRetention idle task and CaribouDataRetention trigger.", "Trigger for backfill relevancy score. see go/gmail-relevancy-scoring-write for detail.", "Trigger to backfill gaps left by pdh pushed via push notification. see go/tingle-moonshine-push-v2", - "Begins the message expunge similar to ACTION_MESSAGE_EXPUNGE but fires within one day. To be used ONLY for auto save drafts. See go/faster-auto-save-draft-deletion for more details." + "Begins the message expunge similar to ACTION_MESSAGE_EXPUNGE but fires within one day. To be used ONLY for auto save drafts. See go/faster-auto-save-draft-deletion for more details.", + "Trigger for relevancy score catchup. See go/relevancy-trigger-doc for detail." ], "type": "string" }, diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index ca3f6f0e1bb..9c044c4428b 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -21270,6 +21270,45 @@ func (s *RpcOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SafeHtmlProto: IMPORTANT: It is unsafe to accept this message from an +// untrusted source, since it's trivial for an attacker to forge +// serialized messages that don't fulfill the type's safety contract -- +// for example, it could contain attacker controlled script. A system +// which receives a SafeHtmlProto implicitly trusts the producer of the +// SafeHtmlProto. So, it's generally safe to return this message in RPC +// responses, but generally unsafe to accept it in RPC requests. +type SafeHtmlProto struct { + // PrivateDoNotAccessOrElseSafeHtmlWrappedValue: IMPORTANT: Never set or + // read this field, even from tests, it is private. See documentation at + // the top of .proto file for programming language packages with which + // to create or read this message. + PrivateDoNotAccessOrElseSafeHtmlWrappedValue string `json:"privateDoNotAccessOrElseSafeHtmlWrappedValue,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "PrivateDoNotAccessOrElseSafeHtmlWrappedValue") 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. + // "PrivateDoNotAccessOrElseSafeHtmlWrappedValue") 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 *SafeHtmlProto) MarshalJSON() ([]byte, error) { + type NoMethod SafeHtmlProto + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SafeUrlProto: Message containing a string that is safe to use in URL // contexts in DOM APIs and HTML documents, where the URL context does // not refer to a resource that loads code. @@ -23082,6 +23121,12 @@ type SpellResult struct { // SuggestedQuery: The suggested spelling of the query. SuggestedQuery string `json:"suggestedQuery,omitempty"` + // SuggestedQueryHtml: The sanitized HTML representing the spell + // corrected query that can be used in the UI. This usually has + // language-specific tags to mark up parts of the query that are spell + // checked. + SuggestedQueryHtml *SafeHtmlProto `json:"suggestedQueryHtml,omitempty"` + // SuggestionType: Suggestion triggered for the current query. // // Possible values: @@ -24640,6 +24685,8 @@ type TriggerAction struct { // similar to ACTION_MESSAGE_EXPUNGE but fires within one day. To be // used ONLY for auto save drafts. See // go/faster-auto-save-draft-deletion for more details. + // "ACTION_RELEVANCY_SCORE_CATCHUP" - Trigger for relevancy score + // catchup. See go/relevancy-trigger-doc for detail. Action string `json:"action,omitempty"` // Data: Clients should use extensions on the Trigger message instead. diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 765f1bac53a..4bce3f25c41 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -10670,6 +10670,21 @@ "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" + }, + "view": { + "description": "View of the instance template.", + "enum": [ + "BASIC", + "FULL", + "INSTANCE_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Include everything except Partner Metadata.", + "Include everything.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" } }, "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", @@ -10800,6 +10815,21 @@ "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query", "type": "boolean" + }, + "view": { + "description": "View of the instance template.", + "enum": [ + "BASIC", + "FULL", + "INSTANCE_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Include everything except Partner Metadata.", + "Include everything.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" } }, "path": "projects/{project}/global/instanceTemplates", @@ -11342,6 +11372,21 @@ "required": true, "type": "string" }, + "view": { + "description": "View of the instance.", + "enum": [ + "BASIC", + "FULL", + "INSTANCE_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Include everything except Partner Metadata.", + "Include everything.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" + }, "zone": { "description": "The name of the zone for this request.", "location": "path", @@ -11844,6 +11889,21 @@ "location": "query", "type": "boolean" }, + "view": { + "description": "View of the instance.", + "enum": [ + "BASIC", + "FULL", + "INSTANCE_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Include everything except Partner Metadata.", + "Include everything.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" + }, "zone": { "description": "The name of the zone for this request.", "location": "path", @@ -26974,6 +27034,21 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" + }, + "view": { + "description": "View of the instance template.", + "enum": [ + "BASIC", + "FULL", + "INSTANCE_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Include everything except Partner Metadata.", + "Include everything.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" } }, "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", @@ -27079,6 +27154,21 @@ "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query", "type": "boolean" + }, + "view": { + "description": "View of the instance template.", + "enum": [ + "BASIC", + "FULL", + "INSTANCE_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Include everything except Partner Metadata.", + "Include everything.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" } }, "path": "projects/{project}/regions/{region}/instanceTemplates", @@ -41925,7 +42015,7 @@ } } }, - "revision": "20230530", + "revision": "20230606", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -46599,6 +46689,7 @@ "COMPUTE_OPTIMIZED_C2D", "COMPUTE_OPTIMIZED_C3", "COMPUTE_OPTIMIZED_C3D", + "COMPUTE_OPTIMIZED_H3", "GENERAL_PURPOSE", "GENERAL_PURPOSE_E2", "GENERAL_PURPOSE_N2", @@ -46623,6 +46714,7 @@ "", "", "", + "", "" ], "type": "string" @@ -47280,7 +47372,7 @@ "id": "CustomerEncryptionKey", "properties": { "kmsKeyName": { - "description": "The name of the encryption key that is stored in Google Cloud KMS. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key ", + "description": "The name of the encryption key that is stored in Google Cloud KMS. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 ", "type": "string" }, "kmsKeyServiceAccount": { @@ -54180,6 +54272,13 @@ "$ref": "InstanceParams", "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload." }, + "partnerMetadata": { + "additionalProperties": { + "$ref": "StructuredEntries" + }, + "description": "Partner Metadata assigned to the instance. A map from a subdomain (namespace) to entries map.", + "type": "object" + }, "postKeyRevocationActionType": { "description": "PostKeyRevocationActionType of the instance.", "enum": [ @@ -54997,12 +55096,14 @@ "targetSizeUnit": { "description": "The unit of measure for the target size.", "enum": [ + "INSTANCE", "VCPU", "VM" ], "enumDescriptions": [ + "[Default] TargetSize is the target number of instances.", "TargetSize is the target count of vCPUs of VMs.", - "[Default] TargetSize is the target number of VMs." + "TargetSize is the target number of VMs. Deprecated in favor of 'INSTANCE'." ], "type": "string" }, @@ -57207,6 +57308,13 @@ "$ref": "NetworkPerformanceConfig", "description": "Note that for MachineImage, this is not supported yet." }, + "partnerMetadata": { + "additionalProperties": { + "$ref": "StructuredEntries" + }, + "description": "Partner Metadata assigned to the instance properties. A map from a subdomain (namespace) to entries map.", + "type": "object" + }, "postKeyRevocationActionType": { "description": "PostKeyRevocationActionType of the instance.", "enum": [ @@ -57337,10 +57445,6 @@ "description": "[Output Only] Type of the resource. Always compute#instance_settings for instance settings.", "type": "string" }, - "machineType": { - "description": "Partial URL of the machine type resource to use for this instance, in the format: machineTypes/machine-type. This is either provided by the client or chosen by the system. For example, the following is a valid partial url to a predefined machine type: machineTypes/n2-standard-1", - "type": "string" - }, "zone": { "description": "[Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", "type": "string" @@ -70787,6 +70891,18 @@ "metricName": { "description": "The Compute Engine quota metric name.", "type": "string" + }, + "rolloutStatus": { + "description": "Rollout status of the future quota limit.", + "enum": [ + "IN_PROGRESS", + "ROLLOUT_STATUS_UNSPECIFIED" + ], + "enumDescriptions": [ + "IN_PROGRESS - A rollout is in process which will change the limit value to future limit.", + "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value." + ], + "type": "string" } }, "type": "object" @@ -73891,7 +74007,7 @@ "type": "string" }, "nextHopHub": { - "description": "[Output Only] The full resource name of the network connectivity center hub that should handle matching packets.", + "description": "[Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets.", "type": "string" }, "nextHopIlb": { @@ -76856,12 +76972,14 @@ "ruleManagedProtectionTier": { "description": "[Output Only] The minimum managed protection tier required for this rule. [Deprecated] Use requiredManagedProtectionTiers instead.", "enum": [ - "NONE", - "PLUS" + "CAMP_PLUS_ANNUAL", + "CAMP_PLUS_MONTHLY", + "CA_STANDARD" ], "enumDescriptions": [ - "Standard protection.", - "Plus tier protection." + "Plus tier protection annual.", + "Plus tier protection monthly.", + "Standard protection." ], "type": "string" }, @@ -84948,7 +85066,7 @@ "id": "UpcomingMaintenance", "properties": { "canReschedule": { - "description": "Indicates if the maintenance can be customer triggered. From more detail, see go/sf-ctm-design.", + "description": "Indicates if the maintenance can be customer triggered.", "type": "boolean" }, "date": { diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 9984e8561c1..a1256c4100e 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -8836,6 +8836,7 @@ type Commitment struct { // "COMPUTE_OPTIMIZED_C2D" // "COMPUTE_OPTIMIZED_C3" // "COMPUTE_OPTIMIZED_C3D" + // "COMPUTE_OPTIMIZED_H3" // "GENERAL_PURPOSE" // "GENERAL_PURPOSE_E2" // "GENERAL_PURPOSE_N2" @@ -9915,7 +9916,10 @@ type CustomerEncryptionKey struct { // KmsKeyName: The name of the encryption key that is stored in Google // Cloud KMS. For example: "kmsKeyName": // "projects/kms_project_id/locations/region/keyRings/ - // key_region/cryptoKeys/key + // key_region/cryptoKeys/key The fully-qualifed key name may be returned + // for resource GET requests. For example: "kmsKeyName": + // "projects/kms_project_id/locations/region/keyRings/ + // key_region/cryptoKeys/key /cryptoKeyVersions/1 KmsKeyName string `json:"kmsKeyName,omitempty"` // KmsKeyServiceAccount: The service account being used for the @@ -21067,6 +21071,10 @@ type Instance struct { // request, but not persisted as part of resource payload. Params *InstanceParams `json:"params,omitempty"` + // PartnerMetadata: Partner Metadata assigned to the instance. A map + // from a subdomain (namespace) to entries map. + PartnerMetadata map[string]StructuredEntries `json:"partnerMetadata,omitempty"` + // PostKeyRevocationActionType: PostKeyRevocationActionType of the // instance. // @@ -22141,8 +22149,11 @@ type InstanceGroupManager struct { // TargetSizeUnit: The unit of measure for the target size. // // Possible values: + // "INSTANCE" - [Default] TargetSize is the target number of + // instances. // "VCPU" - TargetSize is the target count of vCPUs of VMs. - // "VM" - [Default] TargetSize is the target number of VMs. + // "VM" - TargetSize is the target number of VMs. Deprecated in favor + // of 'INSTANCE'. TargetSizeUnit string `json:"targetSizeUnit,omitempty"` // TargetStoppedSize: The target number of stopped instances for this @@ -26008,6 +26019,10 @@ type InstanceProperties struct { // supported yet. NetworkPerformanceConfig *NetworkPerformanceConfig `json:"networkPerformanceConfig,omitempty"` + // PartnerMetadata: Partner Metadata assigned to the instance + // properties. A map from a subdomain (namespace) to entries map. + PartnerMetadata map[string]StructuredEntries `json:"partnerMetadata,omitempty"` + // PostKeyRevocationActionType: PostKeyRevocationActionType of the // instance. // @@ -26186,13 +26201,6 @@ type InstanceSettings struct { // compute#instance_settings for instance settings. Kind string `json:"kind,omitempty"` - // MachineType: Partial URL of the machine type resource to use for this - // instance, in the format: machineTypes/machine-type. This is either - // provided by the client or chosen by the system. For example, the - // following is a valid partial url to a predefined machine type: - // machineTypes/n2-standard-1 - MachineType string `json:"machineType,omitempty"` - // Zone: [Output Only] URL of the zone where the resource resides You // must specify this field as part of the HTTP request URL. It is not // settable as a field in the request body. @@ -46844,6 +46852,15 @@ type QuotaExceededInfo struct { // MetricName: The Compute Engine quota metric name. MetricName string `json:"metricName,omitempty"` + // RolloutStatus: Rollout status of the future quota limit. + // + // Possible values: + // "IN_PROGRESS" - IN_PROGRESS - A rollout is in process which will + // change the limit value to future limit. + // "ROLLOUT_STATUS_UNSPECIFIED" - ROLLOUT_STATUS_UNSPECIFIED - Rollout + // status is not specified. The default value. + RolloutStatus string `json:"rolloutStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dimensions") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -52012,8 +52029,8 @@ type Route struct { // project/global/gateways/default-internet-gateway NextHopGateway string `json:"nextHopGateway,omitempty"` - // NextHopHub: [Output Only] The full resource name of the network - // connectivity center hub that should handle matching packets. + // NextHopHub: [Output Only] The full resource name of the Network + // Connectivity Center hub that will handle matching packets. NextHopHub string `json:"nextHopHub,omitempty"` // NextHopIlb: The URL to a forwarding rule of type @@ -56248,8 +56265,9 @@ type SecurityPolicyRule struct { // requiredManagedProtectionTiers instead. // // Possible values: - // "NONE" - Standard protection. - // "PLUS" - Plus tier protection. + // "CAMP_PLUS_ANNUAL" - Plus tier protection annual. + // "CAMP_PLUS_MONTHLY" - Plus tier protection monthly. + // "CA_STANDARD" - Standard protection. RuleManagedProtectionTier string `json:"ruleManagedProtectionTier,omitempty"` // RuleNumber: Identifier for the rule. This is only unique within the @@ -69006,7 +69024,7 @@ func (s *Uint128) MarshalJSON() ([]byte, error) { // UpcomingMaintenance: Upcoming Maintenance notification information. type UpcomingMaintenance struct { // CanReschedule: Indicates if the maintenance can be customer - // triggered. From more detail, see go/sf-ctm-design. + // triggered. CanReschedule bool `json:"canReschedule,omitempty"` // Date: [Output Only] The date when the maintenance will take place. @@ -118686,6 +118704,21 @@ func (r *InstanceTemplatesService) Get(project string, instanceTemplate string) return c } +// View sets the optional parameter "view": View of the instance +// template. +// +// Possible values: +// +// "BASIC" - Include everything except Partner Metadata. +// "FULL" - Include everything. +// "INSTANCE_VIEW_UNSPECIFIED" - The default / unset value. The API +// +// will default to the BASIC view. +func (c *InstanceTemplatesGetCall) View(view string) *InstanceTemplatesGetCall { + c.urlParams_.Set("view", view) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -118808,6 +118841,21 @@ func (c *InstanceTemplatesGetCall) Do(opts ...googleapi.CallOption) (*InstanceTe // "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" + // }, + // "view": { + // "description": "View of the instance template.", + // "enum": [ + // "BASIC", + // "FULL", + // "INSTANCE_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Include everything except Partner Metadata.", + // "Include everything.", + // "The default / unset value. The API will default to the BASIC view." + // ], + // "location": "query", + // "type": "string" // } // }, // "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", @@ -119268,6 +119316,21 @@ func (c *InstanceTemplatesListCall) ReturnPartialSuccess(returnPartialSuccess bo return c } +// View sets the optional parameter "view": View of the instance +// template. +// +// Possible values: +// +// "BASIC" - Include everything except Partner Metadata. +// "FULL" - Include everything. +// "INSTANCE_VIEW_UNSPECIFIED" - The default / unset value. The API +// +// will default to the BASIC view. +func (c *InstanceTemplatesListCall) View(view string) *InstanceTemplatesListCall { + c.urlParams_.Set("view", view) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -119409,6 +119472,21 @@ func (c *InstanceTemplatesListCall) Do(opts ...googleapi.CallOption) (*InstanceT // "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", // "location": "query", // "type": "boolean" + // }, + // "view": { + // "description": "View of the instance template.", + // "enum": [ + // "BASIC", + // "FULL", + // "INSTANCE_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Include everything except Partner Metadata.", + // "Include everything.", + // "The default / unset value. The API will default to the BASIC view." + // ], + // "location": "query", + // "type": "string" // } // }, // "path": "projects/{project}/global/instanceTemplates", @@ -121421,6 +121499,20 @@ func (r *InstancesService) Get(project string, zone string, instance string) *In return c } +// View sets the optional parameter "view": View of the instance. +// +// Possible values: +// +// "BASIC" - Include everything except Partner Metadata. +// "FULL" - Include everything. +// "INSTANCE_VIEW_UNSPECIFIED" - The default / unset value. The API +// +// will default to the BASIC view. +func (c *InstancesGetCall) View(view string) *InstancesGetCall { + c.urlParams_.Set("view", view) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -121546,6 +121638,21 @@ func (c *InstancesGetCall) Do(opts ...googleapi.CallOption) (*Instance, error) { // "required": true, // "type": "string" // }, + // "view": { + // "description": "View of the instance.", + // "enum": [ + // "BASIC", + // "FULL", + // "INSTANCE_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Include everything except Partner Metadata.", + // "Include everything.", + // "The default / unset value. The API will default to the BASIC view." + // ], + // "location": "query", + // "type": "string" + // }, // "zone": { // "description": "The name of the zone for this request.", // "location": "path", @@ -123368,6 +123475,20 @@ func (c *InstancesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *Ins return c } +// View sets the optional parameter "view": View of the instance. +// +// Possible values: +// +// "BASIC" - Include everything except Partner Metadata. +// "FULL" - Include everything. +// "INSTANCE_VIEW_UNSPECIFIED" - The default / unset value. The API +// +// will default to the BASIC view. +func (c *InstancesListCall) View(view string) *InstancesListCall { + c.urlParams_.Set("view", view) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -123512,6 +123633,21 @@ func (c *InstancesListCall) Do(opts ...googleapi.CallOption) (*InstanceList, err // "location": "query", // "type": "boolean" // }, + // "view": { + // "description": "View of the instance.", + // "enum": [ + // "BASIC", + // "FULL", + // "INSTANCE_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Include everything except Partner Metadata.", + // "Include everything.", + // "The default / unset value. The API will default to the BASIC view." + // ], + // "location": "query", + // "type": "string" + // }, // "zone": { // "description": "The name of the zone for this request.", // "location": "path", @@ -186075,6 +186211,21 @@ func (r *RegionInstanceTemplatesService) Get(project string, region string, inst return c } +// View sets the optional parameter "view": View of the instance +// template. +// +// Possible values: +// +// "BASIC" - Include everything except Partner Metadata. +// "FULL" - Include everything. +// "INSTANCE_VIEW_UNSPECIFIED" - The default / unset value. The API +// +// will default to the BASIC view. +func (c *RegionInstanceTemplatesGetCall) View(view string) *RegionInstanceTemplatesGetCall { + c.urlParams_.Set("view", view) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -186206,6 +186357,21 @@ func (c *RegionInstanceTemplatesGetCall) Do(opts ...googleapi.CallOption) (*Inst // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", // "required": true, // "type": "string" + // }, + // "view": { + // "description": "View of the instance template.", + // "enum": [ + // "BASIC", + // "FULL", + // "INSTANCE_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Include everything except Partner Metadata.", + // "Include everything.", + // "The default / unset value. The API will default to the BASIC view." + // ], + // "location": "query", + // "type": "string" // } // }, // "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", @@ -186505,6 +186671,21 @@ func (c *RegionInstanceTemplatesListCall) ReturnPartialSuccess(returnPartialSucc return c } +// View sets the optional parameter "view": View of the instance +// template. +// +// Possible values: +// +// "BASIC" - Include everything except Partner Metadata. +// "FULL" - Include everything. +// "INSTANCE_VIEW_UNSPECIFIED" - The default / unset value. The API +// +// will default to the BASIC view. +func (c *RegionInstanceTemplatesListCall) View(view string) *RegionInstanceTemplatesListCall { + c.urlParams_.Set("view", view) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -186655,6 +186836,21 @@ func (c *RegionInstanceTemplatesListCall) Do(opts ...googleapi.CallOption) (*Ins // "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", // "location": "query", // "type": "boolean" + // }, + // "view": { + // "description": "View of the instance template.", + // "enum": [ + // "BASIC", + // "FULL", + // "INSTANCE_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Include everything except Partner Metadata.", + // "Include everything.", + // "The default / unset value. The API will default to the BASIC view." + // ], + // "location": "query", + // "type": "string" // } // }, // "path": "projects/{project}/regions/{region}/instanceTemplates", diff --git a/contentwarehouse/v1/contentwarehouse-api.json b/contentwarehouse/v1/contentwarehouse-api.json index ee4126201f3..a96d537487a 100644 --- a/contentwarehouse/v1/contentwarehouse-api.json +++ b/contentwarehouse/v1/contentwarehouse-api.json @@ -1103,7 +1103,7 @@ } } }, - "revision": "20230604", + "revision": "20230612", "rootUrl": "https://contentwarehouse.googleapis.com/", "schemas": { "AbuseiamAbuseType": { @@ -3629,7 +3629,8 @@ "PMW_TI_AFFINITY", "DRIVE_SEARCH_FILTER_PERSON_ONLY", "ACCESSIBILITY_TRACKER_AFFINITY", - "PLX_DATASOURCE_AFFINITY" + "PLX_DATASOURCE_AFFINITY", + "DUCKIEWEB_AFFINITY" ], "enumDescriptions": [ "", @@ -3883,6 +3884,7 @@ "", "", "", + "", "" ], "type": "string" @@ -9354,7 +9356,6 @@ "type": "array" }, "supportsDuoEmailEndpoint": { - "description": "Whether the surface supports Duo calling email endpoints.", "type": "boolean" } }, @@ -9579,6 +9580,7 @@ "AUTO_ROTATE", "AUTO_ROTATE_FACE_DETECTION", "BACKUP", + "BATTERY_HEALTH", "BATTERY_LEVEL", "BATTERY_LOW", "BATTERY_PERCENTAGE", @@ -9805,6 +9807,14 @@ "TIPS_AND_SUPPORT", "SCREEN_ATTENTION", "BLUETOOTH_TETHERING", + "ALL_APPS", + "EXTEND_UNLOCK", + "CLEAR_CALLING", + "GOOGLE_SETTINGS", + "APP_LANGUAGES", + "SIM_STATUS", + "MICROPHONE_PERMISSIONS", + "GOOGLE_PLAY_UPDATE", "ABOUT_PHONE", "ACCOUNTS", "APPLICATION", @@ -9893,6 +9903,7 @@ "", "", "", + "Denotes if the battery health is normal / reduced / unknown.", "", "", "", @@ -10119,6 +10130,14 @@ "Settings \u003e Tips \u0026 support", "Display \u003e Screen timeout \u003e Screen attention", "", + "", + "", + "", + "", + "", + "", + "Permission Manager \u003e Microphone", + "", "Begin of NGA proto consistence", "", "", @@ -13002,11 +13021,6 @@ "description": "Data which is produced for logging and debugging. Servers MUST NOT use this for any other purposes, such as branching on it. Next ID: 16", "id": "AssistantApiLoggingOnlyData", "properties": { - "accountIndex": { - "description": "The index of the account on the device. Useful when there are multiple accounts on a device. There is no guarantee that this is a stable number but is relatively stable in practice.", - "format": "int32", - "type": "integer" - }, "acpVersion": { "description": "A user-readable string describing the ACP version (go/acp-version) of the client app used by the user to originate the conversation.", "type": "string" @@ -13614,10 +13628,6 @@ ], "type": "string" }, - "supportsProactiveOutput": { - "description": "Whether a device supports proactive output. Note that this is assumed to be true for all Smart Display devices, but surfaces that newly start supporting proactive_output should set this bit.", - "type": "boolean" - }, "userMatchProactive": { "description": "Settings for displaying personal data on proactive surfaces with face match capability.", "enum": [ @@ -16781,6 +16791,76 @@ }, "type": "object" }, + "AssistantContextProviderSelectionPolicy": { + "description": "Identifies a business policy used for selecting a given content provider in the form of a name and a resulting scoring action.", + "id": "AssistantContextProviderSelectionPolicy", + "properties": { + "policyAction": { + "description": "Result of applying the policy.", + "enum": [ + "UNSET_ACTION", + "BOOST_TO_WIN_ACTION", + "SUPPRESS_TO_INVALIDATE_ACTION" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "policyName": { + "description": "Name of the policy.", + "enum": [ + "UNSET_POLICY", + "QUERY_RESTRICTED_SPOTIFY_POLICY", + "QUERY_RESTRICTED_PANDORA_POLICY", + "QUERY_RESTRICTED_NETFLIX_POLICY" + ], + "enumDescriptions": [ + "", + "Candidate should win if the provider_id is Spotify, and the query specified to play the content on Spotify. See go/sp-policy-spotify.", + "Candidate should win if the provider_id is Pandora, and the query specified to play the content on Pandora. See go/sp-policy-pandora.", + "Candidate should win if the provider_id is Netflix, and the query specified to play the content on Netflix. See go/sp-policy-netflix." + ], + "type": "string" + } + }, + "type": "object" + }, + "AssistantContextProviderSelectionResult": { + "description": "Message that gets returned from the Provider Selection Library (PSL). It encodes the scores, applied policies, and pruning decisions for a given provider candidate.", + "id": "AssistantContextProviderSelectionResult", + "properties": { + "bucketedFinalScore": { + "description": "Alternative bucketed score for use by downstream ranking providers. A raw numeric score is subject to semantic-drift, while a bucket is not.", + "enum": [ + "DEFAULT_BUCKET" + ], + "enumDescriptions": [ + "" + ], + "type": "string" + }, + "finalScore": { + "description": "Final score in the range [0,1] that can be used for ranking providers. Incorporates both policy rules and quality considerations.", + "format": "float", + "type": "number" + }, + "policyApplied": { + "description": "List of business policies applied to the candidate.", + "items": { + "$ref": "AssistantContextProviderSelectionPolicy" + }, + "type": "array" + }, + "shouldPrune": { + "description": "Indicates whether the candidate should be pruned.", + "type": "boolean" + } + }, + "type": "object" + }, "AssistantContextProviderVariant": { "description": "Note: As of May 2021, multiple providers use the same mids (e.g. YouTube Main, YouTube Go, and YouTube Music all have the same mids). However, quite often we end up using surface specific identifiers (e.g. Android package names, iOS bundle identifiers, etc.) to differentiate amongst them. This field allows us to move away from surface specific identifiers towards a surface-agnostic enum representing the same information.", "id": "AssistantContextProviderVariant", @@ -16862,7 +16942,8 @@ "MISSING_LOCAL_DEVICE_SETTING", "NO_DEVICE_HAS_REQUIRED_APP", "HYBRID_DEVICE_NOT_QUALIFIED", - "NO_NEARBY_DEVICES" + "NO_NEARBY_DEVICES", + "NO_MATCHING_LAST_USED_DEVICE" ], "enumDescriptions": [ "", @@ -16892,7 +16973,8 @@ "AvailableDevice device setting of local device is missing.", "Required app is not installed", "All remote hybrid devices fail the propertries requirement specific (lock/unlock, etc) for hybrid devices (such as Tangor).", - "No nearby hearing devices" + "No nearby hearing devices", + "No matching device for the LastUsedDevice requirement found." ], "type": "string" } @@ -17556,6 +17638,55 @@ }, "type": "object" }, + "AssistantGroundingProviderProviderSignalResult": { + "description": "Message containing the processed provider signals. This message is consumed by systems outside of the Provider GP, such as the HGR. For use of provider signals within the Provider GP, please refer to the CTF-governed PackedProviderSignals defined in: cs/google3/assistant/context/proto/packed_provider_signals.proto;rcl=486224300;l=68", + "id": "AssistantGroundingProviderProviderSignalResult", + "properties": { + "isDefaultProvider": { + "description": "Whether the provider is the default provider for the BII and entity type. Also known as the 'preferred_provider'.", + "type": "boolean" + }, + "isForegroundProvider": { + "description": "Whether the provider is currently open in the foreground on the device.", + "type": "boolean" + }, + "isInAppProvider": { + "description": "Indicates that fulfillment on this provider will happen within the provider app", + "type": "boolean" + }, + "isInstalled": { + "description": "Whether the provider is installed, or otherwise reachable, from the device.", + "type": "boolean" + }, + "isLastUsedProvider": { + "description": "Whether the provider was the last-used provider for this intent on the device. Also known as the 'sticky_provider'.", + "type": "boolean" + }, + "isQueryRestrictedProvider": { + "description": "Whether the provider was specified by the query.", + "type": "boolean" + }, + "providerSelectionResult": { + "$ref": "AssistantContextProviderSelectionResult", + "description": "The result of running provider-selection on the provider candidate. This is populated by the Signal Extractor after the PSL has been run." + }, + "providerTypeSignal": { + "description": "Contains the \"fulfillment type\" of provider eg whether it's 0p or System API provider.", + "enum": [ + "UNKNOWN_TYPE", + "ZEROTH_PARTY_TYPE", + "ANDROID_SYSTEM_API_TYPE" + ], + "enumDescriptions": [ + "", + "Provider fulfillment is through 0-party assistant app (AGSA) on mobile or 0-party libassistant on other surfaces. See go/0p-and-system-api-in-pc.", + "Provider fulfillment is through Android System API. See go/0p-and-system-api-in-pc." + ], + "type": "string" + } + }, + "type": "object" + }, "AssistantGroundingRankerAssistantInteractionFeatures": { "id": "AssistantGroundingRankerAssistantInteractionFeatures", "properties": { @@ -18232,13 +18363,9 @@ "type": "object" }, "AssistantGroundingRankerProviderGroundingProviderFeatures": { - "description": "Features to be extracted from Provider GP for ranking in HGR. Next ID: 6", + "description": "Features to be extracted from Provider GP for ranking in HGR. Next ID: 7", "id": "AssistantGroundingRankerProviderGroundingProviderFeatures", "properties": { - "isInAppProvider": { - "description": "Indicates that fulfillment on this provider will happen within the provider app.", - "type": "boolean" - }, "providerClusterIds": { "description": "Cluster IDs for the provider. This field is repeated because some providers can be associated with multiple clusters. PRR specific feature.", "items": { @@ -18251,6 +18378,10 @@ "$ref": "AssistantContextProviderId", "description": "ProviderId for the provider in the binding set. PRR specific feature." }, + "providerSignalResult": { + "$ref": "AssistantGroundingProviderProviderSignalResult", + "description": "Provider signals extracted from Provider GP." + }, "pslScore": { "description": "Provider quality score in the range [0,1] that can be used for ranking providers. Incorporates both policy rules and quality considerations.", "format": "float", @@ -18831,6 +18962,7 @@ "HYBRID_DEVICE_PROPERTIES_FILTER", "NEARBY_DEVICE_FILTER", "DEVICE_ATTRIBUTES_FILTER", + "LAST_USED_DEVICE_FILTER", "DEFAULT_MEDIA_OUTPUT_PROMOTER", "DEVICE_GROUP_PROMOTER", "LOCAL_DEVICE_PROMOTER", @@ -18859,6 +18991,7 @@ "", "", "", + "", "promoters", "", "", @@ -19340,7 +19473,8 @@ "MISSING_LOCAL_DEVICE_SETTING", "NO_DEVICE_HAS_REQUIRED_APP", "HYBRID_DEVICE_NOT_QUALIFIED", - "NO_NEARBY_DEVICES" + "NO_NEARBY_DEVICES", + "NO_MATCHING_LAST_USED_DEVICE" ], "enumDescriptions": [ "", @@ -19370,7 +19504,8 @@ "AvailableDevice device setting of local device is missing.", "Required app is not installed", "All remote hybrid devices fail the propertries requirement specific (lock/unlock, etc) for hybrid devices (such as Tangor).", - "No nearby hearing devices" + "No nearby hearing devices", + "No matching device for the LastUsedDevice requirement found." ], "type": "string" }, @@ -19553,6 +19688,7 @@ "HYBRID_DEVICE_PROPERTIES_FILTER", "NEARBY_DEVICE_FILTER", "DEVICE_ATTRIBUTES_FILTER", + "LAST_USED_DEVICE_FILTER", "DEFAULT_MEDIA_OUTPUT_PROMOTER", "DEVICE_GROUP_PROMOTER", "LOCAL_DEVICE_PROMOTER", @@ -19581,6 +19717,7 @@ "", "", "", + "", "promoters", "", "", @@ -20073,7 +20210,7 @@ "type": "object" }, "AssistantPrefulfillmentRankerPrefulfillmentSignals": { - "description": "Signals to be used by the Prefulfillment Ranker. Derived from the ParsingSignals and GroundingSignals carried by the FunctionCall. LINT.IfChange Next ID: 55", + "description": "Signals to be used by the Prefulfillment Ranker. Derived from the ParsingSignals and GroundingSignals carried by the FunctionCall. LINT.IfChange Next ID: 57", "id": "AssistantPrefulfillmentRankerPrefulfillmentSignals", "properties": { "bindingSetAuis": { @@ -20197,10 +20334,18 @@ "description": "Whether the intent is a podcast intent.", "type": "boolean" }, + "isSageIntent": { + "description": "Whether this intent was generated by Sage.", + "type": "boolean" + }, "isTvmIntent": { "description": "Whether the intent is a media object tvm intent.", "type": "boolean" }, + "isValidSmarthomeIntent": { + "description": "Whether the intent is a Smarthome-domain intent with valid device arguments.", + "type": "boolean" + }, "isVideoIntent": { "description": "Whether the intent is a media object video intent.", "type": "boolean" @@ -21771,7 +21916,8 @@ "DIALOGFLOW_DELEGATION", "AD_LEAD_VERIFICATION", "GET_HUMAN", - "CHECK_INSURANCE_ACCEPTANCE" + "CHECK_INSURANCE_ACCEPTANCE", + "FREE_TEXT" ], "enumDescriptions": [ "// Data extraction:", @@ -21820,7 +21966,8 @@ "Duplex for Business - Dialogflow delegation module for CCAI integration.", "Duplex for Business - ad lead verification module for GLS integration.", "Get Human bot.", - "Check health insurance acceptance." + "Check health insurance acceptance.", + "Wrapper use case for creating an errand from conversational free-text. The true use case for the errand will be provided by a call to the LBT backend's task routing logic, such that this use case should NOT actually ever reach the caller." ], "type": "string" } @@ -41532,6 +41679,10 @@ "$ref": "GeostoreFeatureIdProto", "description": "Restriction group this restriction belongs to." }, + "restrictionToken": { + "description": "A token that can be used to identify the version of the data about this restriction.", + "type": "string" + }, "schedule": { "$ref": "GeostoreTimeScheduleProto", "description": "When specified, restriction applies only at particular times (operating hours or times of the year: reversing lanes, seasonal roads, no left turns from 3-5pm Mon-Fri except holidays). Otherwise, restriction is in effect at all times." @@ -45629,11 +45780,13 @@ "description": "Indicates if an error occurred while fetching alarm state. If this value is missing, it can be assumed that the state fetch was successful.", "enum": [ "STATE_FETCH_ERROR_UNSPECIFIED", - "STATE_FETCH_ERROR_TIMEOUT" + "STATE_FETCH_ERROR_TIMEOUT", + "STATE_FETCH_ERROR_UNSUPPORTED" ], "enumDescriptions": [ "Equivalent to no errors from fetching state (i.e. success).", - "The time taken to fetch state exceeded the allowed maximum time." + "The time taken to fetch state exceeded the allowed maximum time.", + "State fetch is not supported in Stateless Timer/Alarm Integration. This is expected for Stateless Integration." ], "type": "string" } @@ -45963,11 +46116,13 @@ "description": "Indicates if an error occurred while fetching timer state. If this value is missing, it can be assumed that the state fetch was successful.", "enum": [ "STATE_FETCH_ERROR_UNSPECIFIED", - "STATE_FETCH_ERROR_TIMEOUT" + "STATE_FETCH_ERROR_TIMEOUT", + "STATE_FETCH_ERROR_UNSUPPORTED" ], "enumDescriptions": [ "Equivalent to no errors from fetching state (i.e. success).", - "The time taken to fetch state exceeded the allowed maximum time." + "The time taken to fetch state exceeded the allowed maximum time.", + "State fetch is not supported in Stateless Timer/Alarm Integration. This is expected for Stateless Integration." ], "type": "string" }, @@ -46875,6 +47030,10 @@ ], "type": "string" }, + "enableCalUserEmailLogging": { + "description": "Optional. Whether to enable CAL user email logging.", + "type": "boolean" + }, "kmsKey": { "description": "Optional. The KMS key used for CMEK encryption. It is required that the kms key is in the same region as the endpoint. The same key will be used for all provisioned resources, if encryption is available. If the kms_key is left empty, no encryption will be enforced.", "type": "string" @@ -47452,12 +47611,16 @@ "enum": [ "UNKNOWN", "ON_CREATE", - "ON_UPDATE" + "ON_UPDATE", + "ON_CREATE_LINK", + "ON_DELETE_LINK" ], "enumDescriptions": [ "Trigger for unknown action.", "Trigger for create document action.", - "Trigger for update document action." + "Trigger for update document action.", + "Trigger for create link action.", + "Trigger for delete link action." ], "type": "string" } @@ -50072,7 +50235,7 @@ "type": "object" }, "GoogleTypeColor": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "GoogleTypeColor", "properties": { "alpha": { @@ -57639,6 +57802,9 @@ "acceleratedShoppingSignal": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, + "authenticSiteRankData": { + "$ref": "IndexingDocjoinerDataVersionVersionInfo" + }, "chromeCounts": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, @@ -57646,8 +57812,7 @@ "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, "discoverSource": { - "$ref": "IndexingDocjoinerDataVersionVersionInfo", - "description": "LINT.ThenChange(//depot/google3/indexing/ames/spanner/schema/web-version.proto)" + "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, "discussion": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" @@ -57655,6 +57820,12 @@ "documentIntent": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, + "extractedBookInfo": { + "$ref": "IndexingDocjoinerDataVersionVersionInfo" + }, + "instantChromeViews": { + "$ref": "IndexingDocjoinerDataVersionVersionInfo" + }, "instantNavboost": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, @@ -57665,12 +57836,17 @@ "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, "navboost": { - "$ref": "IndexingDocjoinerDataVersionVersionInfo", - "description": "LINT.IfChange" + "$ref": "IndexingDocjoinerDataVersionVersionInfo" + }, + "predictedAuthenticity": { + "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, "rankembed": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, + "rosettaLanguage": { + "$ref": "IndexingDocjoinerDataVersionVersionInfo" + }, "universalFacts": { "$ref": "IndexingDocjoinerDataVersionVersionInfo" }, @@ -79337,6 +79513,7 @@ "GSOX_MOCHI", "PMW_TI", "ACCESSIBILITY_TRACKER", + "DUCKIEWEB", "DEPRECATED_QUICKSTART_FLUME", "DUO_CLIENT", "ALBERT", @@ -79980,6 +80157,7 @@ "Gsox Mochi Team contact: fintechops-eng@google.com", "Pmw Ti Team contact: pmw-ti", "Accessibility Tracker Team contact: a11y-tracker-eng@google.com", + "Duckieweb Team contact: workflow-horizontals-core@google.com", "", "Duo Client Team contact: duo-eng@google.com", "Project albert (go/albert-frontend) Team contact: albert-eng@google.com", @@ -84721,9 +84899,10 @@ "HEADPHONE_PERSONAL_RESULTS_OPTIN", "DISCOVERY_SPARKS", "SPOKEN_NOTIFICATIONS_OOBE_OPTIN", - "PROACTIVE_TRAIN_STATUS", - "PROACTIVE_TRAIN_DELAY", - "PROACTIVE_TRAIN_PLATFORM", + "SPOKEN_NOTIFICATIONS_BNS_MIGRATION_OOBE", + "TRAIN_STATUS", + "TRAIN_DELAY", + "TRAIN_PLATFORM", "UNIT_TESTING" ], "enumDescriptions": [ @@ -85140,6 +85319,7 @@ "Notification for Headphone Personal Response (HPR) opt-in: go/migrate-pr-notifs-tng-ma-prd", "go/habits-sparks-design", "Notification for Spoken Notifications OOBE opt-in. go/mapa-notifications-prd", + "Notification for Spoken Notifications BNS Migration OOBE. go/bns-mapa-migration-notifications-prd", "Notifications for Train Journeys go/proactive-assistant-india-mvp", "", "", @@ -88109,7 +88289,7 @@ "GOOGLE_SCREENSHOT", "MUGSHOT", "CRIME", - "SHOPPING_TOPN", + "PRODUCT_TOPN", "AUTHENTICITY", "INFORMATION_SOURCE_OTHER", "INFORMATION_SOURCE_NEWS_PUBLISHER", @@ -88119,6 +88299,7 @@ "INFORMATION_SOURCE_UGC", "INFORMATION_SOURCE_RESEARCH_INSTITUTE", "QNA", + "UGC_DISCUSSION", "RESERVED_FOR_NEW_ENUM_135", "RESERVED_FOR_NEW_ENUM_136", "RESERVED_FOR_NEW_ENUM_137", @@ -88140,7 +88321,6 @@ "RESERVED_FOR_NEW_ENUM_153", "RESERVED_FOR_NEW_ENUM_154", "RESERVED_FOR_NEW_ENUM_155", - "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_99", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_101", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_102", @@ -88267,7 +88447,7 @@ "This is an image intent", "Image intent representing whether there is a mugshot in the image (or if the image is itself a mugshot).", "Document intent representing whether a page is crime-related (go/crime-demotion-in-image-search-dd)", - "Document intent representing whether a page is recommending best shopping products fulfilling certain application (e.g. \"best laptops for students\"). See go/shopping_topn_orbit.", + "Document intents that provide analysis, opinions of a list of top-recommended products, and focus on multiple specific products individually. See go/sdu-shopping-page-intro#heading=h.r7a5gewp8do.", "AuthenticityScore for document. see go/astar-dd.", "Document intents for various information sources. They are used in Tangram Diversity. see tangram_diversity_annotation.proto.", "", @@ -88277,6 +88457,7 @@ "", "", "Question and Answer format discussion page. check go/orbit-doc-intents for detailed intent description.", + "Document intent for whether a page is a ugc discussion. For the definition, please see the furball template go/ugc-discussion-template. Note that this is semantically the union of QNA and FORUM doc level intents. For the reason why we want it to be a single intent, see https://docs.google.com/document/d/1Ka3qcMWLvNHCZMomekHXXTumr_9g_tcgJ0BD6ev1HI4/edit?resourcekey=0-8r1KcmFaOH11GBK_yfipHA", "========== Enums for new intents ========== Instructions: When adding a new intent, use the reserved enum number from the start of this list, and add a new reserved enum number to the end for the next person. There is a unit test that checks there are at least 20 reserved enums. See go/new-intentkeyenum for details.", "", "", @@ -88326,7 +88507,6 @@ "", "", "", - "", "========== Enums for deleted intents ==========", "", "", @@ -88446,7 +88626,7 @@ "GOOGLE_SCREENSHOT", "MUGSHOT", "CRIME", - "SHOPPING_TOPN", + "PRODUCT_TOPN", "AUTHENTICITY", "INFORMATION_SOURCE_OTHER", "INFORMATION_SOURCE_NEWS_PUBLISHER", @@ -88456,6 +88636,7 @@ "INFORMATION_SOURCE_UGC", "INFORMATION_SOURCE_RESEARCH_INSTITUTE", "QNA", + "UGC_DISCUSSION", "RESERVED_FOR_NEW_ENUM_135", "RESERVED_FOR_NEW_ENUM_136", "RESERVED_FOR_NEW_ENUM_137", @@ -88477,7 +88658,6 @@ "RESERVED_FOR_NEW_ENUM_153", "RESERVED_FOR_NEW_ENUM_154", "RESERVED_FOR_NEW_ENUM_155", - "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_99", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_101", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_102", @@ -88604,7 +88784,7 @@ "This is an image intent", "Image intent representing whether there is a mugshot in the image (or if the image is itself a mugshot).", "Document intent representing whether a page is crime-related (go/crime-demotion-in-image-search-dd)", - "Document intent representing whether a page is recommending best shopping products fulfilling certain application (e.g. \"best laptops for students\"). See go/shopping_topn_orbit.", + "Document intents that provide analysis, opinions of a list of top-recommended products, and focus on multiple specific products individually. See go/sdu-shopping-page-intro#heading=h.r7a5gewp8do.", "AuthenticityScore for document. see go/astar-dd.", "Document intents for various information sources. They are used in Tangram Diversity. see tangram_diversity_annotation.proto.", "", @@ -88614,6 +88794,7 @@ "", "", "Question and Answer format discussion page. check go/orbit-doc-intents for detailed intent description.", + "Document intent for whether a page is a ugc discussion. For the definition, please see the furball template go/ugc-discussion-template. Note that this is semantically the union of QNA and FORUM doc level intents. For the reason why we want it to be a single intent, see https://docs.google.com/document/d/1Ka3qcMWLvNHCZMomekHXXTumr_9g_tcgJ0BD6ev1HI4/edit?resourcekey=0-8r1KcmFaOH11GBK_yfipHA", "========== Enums for new intents ========== Instructions: When adding a new intent, use the reserved enum number from the start of this list, and add a new reserved enum number to the end for the next person. There is a unit test that checks there are at least 20 reserved enums. See go/new-intentkeyenum for details.", "", "", @@ -88663,7 +88844,6 @@ "", "", "", - "", "========== Enums for deleted intents ==========", "", "", @@ -88788,7 +88968,7 @@ "GOOGLE_SCREENSHOT", "MUGSHOT", "CRIME", - "SHOPPING_TOPN", + "PRODUCT_TOPN", "AUTHENTICITY", "INFORMATION_SOURCE_OTHER", "INFORMATION_SOURCE_NEWS_PUBLISHER", @@ -88798,6 +88978,7 @@ "INFORMATION_SOURCE_UGC", "INFORMATION_SOURCE_RESEARCH_INSTITUTE", "QNA", + "UGC_DISCUSSION", "RESERVED_FOR_NEW_ENUM_135", "RESERVED_FOR_NEW_ENUM_136", "RESERVED_FOR_NEW_ENUM_137", @@ -88819,7 +89000,6 @@ "RESERVED_FOR_NEW_ENUM_153", "RESERVED_FOR_NEW_ENUM_154", "RESERVED_FOR_NEW_ENUM_155", - "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_99", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_101", "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_102", @@ -88946,7 +89126,7 @@ "This is an image intent", "Image intent representing whether there is a mugshot in the image (or if the image is itself a mugshot).", "Document intent representing whether a page is crime-related (go/crime-demotion-in-image-search-dd)", - "Document intent representing whether a page is recommending best shopping products fulfilling certain application (e.g. \"best laptops for students\"). See go/shopping_topn_orbit.", + "Document intents that provide analysis, opinions of a list of top-recommended products, and focus on multiple specific products individually. See go/sdu-shopping-page-intro#heading=h.r7a5gewp8do.", "AuthenticityScore for document. see go/astar-dd.", "Document intents for various information sources. They are used in Tangram Diversity. see tangram_diversity_annotation.proto.", "", @@ -88956,6 +89136,7 @@ "", "", "Question and Answer format discussion page. check go/orbit-doc-intents for detailed intent description.", + "Document intent for whether a page is a ugc discussion. For the definition, please see the furball template go/ugc-discussion-template. Note that this is semantically the union of QNA and FORUM doc level intents. For the reason why we want it to be a single intent, see https://docs.google.com/document/d/1Ka3qcMWLvNHCZMomekHXXTumr_9g_tcgJ0BD6ev1HI4/edit?resourcekey=0-8r1KcmFaOH11GBK_yfipHA", "========== Enums for new intents ========== Instructions: When adding a new intent, use the reserved enum number from the start of this list, and add a new reserved enum number to the end for the next person. There is a unit test that checks there are at least 20 reserved enums. See go/new-intentkeyenum for details.", "", "", @@ -89005,7 +89186,6 @@ "", "", "", - "", "========== Enums for deleted intents ==========", "", "", @@ -96396,6 +96576,7 @@ "UNKNOWN", "DEFINITE", "INDEFINITE", + "FEMININE_DETERMINER", "ABLATIVE", "ADESSIVE", "ALLATIVE", @@ -96496,6 +96677,7 @@ "", "Articles or markers that express the definitess of a noun (see go/wordgraph/definiteness).", "Articles or markers that express the indefiniteness of a noun (see go/wordgraph/definiteness).", + "Determiners that mark *unambiguously* the feminine gender of the expression (e.g.: \"*une* artiste\")", "Linguistic markers that express the movement from a place (like the English preposition *from* in a sentence like \"I came *from* my place\").", "Linguistic markers that express the location *near* a place (like in the English preposition *near* in a sentence like \"I am near the house\").", "Linguistic markers that express the movement towards a place (like the English preposition *to* in a sentence like \"I go *to* my house\").", @@ -100662,7 +100844,7 @@ }, "gfv": { "$ref": "ResearchScamGenericFeatureVector", - "description": "The field isn't tpopulated by default, but when enabled (eg, in the ground-truth pipeline), this field provides the original database GFV corresponding to this result." + "description": "The field isn't populated by default, but when enabled (eg, in the ground-truth pipeline), this field provides the original database GFV corresponding to this result." }, "metadata": { "description": "Metadata about the neighbor. This is returned under some configurations as a serialized proto. The specific proto depends on which metadata is configured to be returned.", @@ -102725,6 +102907,11 @@ "format": "int32", "type": "integer" }, + "CitationSourceCrawlTimestamp": { + "description": "Seconds since the epoch, should be consistent with CitationSourceUrl.", + "format": "int64", + "type": "string" + }, "CitationSourceUrl": { "description": "url where record came from", "type": "string" @@ -111993,6 +112180,7 @@ "USER_P13N_SETTING_OFF_AT_EVENT_LEVEL", "BOOKS_USER_P13N_SETTING_OFF_AT_EVENT_LEVEL", "BATTLESTAR_GAME_IN_MDP_EVENT_LEVEL", + "BATTLESTAR_PSEUDO_CREDIT_OFFER_IN_DP_EVENT_LEVEL", "REVIEW_HIGHLIGHTS_TRIGGERING_EVENT_LEVEL", "TRUSTED_VERTICAL_VPN_INTENT_EVENT_LEVEL", "TRUSTED_VERTICAL_LOAN_INTENT_EVENT_LEVEL", @@ -112001,6 +112189,9 @@ "QUERY_TYPE_MDP_EVENT_LEVEL", "QUERY_TYPE_NON_MDP_EVENT_LEVEL", "NAV_CARD_EVENT_LEVEL", + "MDP_WITH_LIVE_OPS_EVER_INSTALLED_USERS_EVENT_LEVEL", + "MDP_WITH_LIVE_OPS_NEVER_INSTALLED_USERS_EVENT_LEVEL", + "BROAD_RELATED_QUERIES_CLUSTER_EVENT", "EVENT_LEVEL_TEST_CODE_LIMIT", "ENTERTAINMENT_CLUSTER_TRIGGERING_AT_SESSION_LEVEL", "BEST_SELLER_CART_TAG_AT_SESSION_LEVEL", @@ -112166,6 +112357,9 @@ "IN_APP_OFFER_APP_4_AT_SESSION_LEVEL", "IN_APP_OFFER_BATTLESTAR_APP_GAMELOFT_AT_SESSION_LEVEL", "IN_APP_OFFER_BATTLESTAR_APP_EVONY_AT_SESSION_LEVEL", + "IN_APP_OFFER_BATTLESTAR_APP_ASPHALT_9_AT_SESSION_LEVEL", + "IN_APP_OFFER_BATTLESTAR_APP_MAGIC_RAMPAGE_AT_SESSION_LEVEL", + "IN_APP_OFFER_BATTLESTAR_APP_SUMMONERS_WAR_AT_SESSION_LEVEL", "IN_APP_OFFER_ELIGIBLE_AT_SESSION_LEVEL", "IN_APP_OFFER_ELIGIBLE_APP_1_AT_SESSION_LEVEL", "IN_APP_OFFER_ELIGIBLE_APP_2_AT_SESSION_LEVEL", @@ -112173,6 +112367,9 @@ "IN_APP_OFFER_ELIGIBLE_APP_4_AT_SESSION_LEVEL", "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_GAMELOFT_AT_SESSION_LEVEL", "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_EVONY_AT_SESSION_LEVEL", + "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_ASPHALT_9_AT_SESSION_LEVEL", + "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_MAGIC_RAMPAGE_AT_SESSION_LEVEL", + "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_SUMMONERS_WAR_AT_SESSION_LEVEL", "IN_APP_OFFER_SAVED_AT_SESSION_LEVEL", "IN_APP_OFFER_SAVED_APP_1_AT_SESSION_LEVEL", "IN_APP_OFFER_SAVED_APP_2_AT_SESSION_LEVEL", @@ -112461,6 +112658,48 @@ "SHOULD_SEE_TOP_NOW_CONTENT_MERCH_NEW_RELEASE_GH", "SHOULD_SEE_TOP_NOW_CONTENT_MERCH_PRE_REGISTRATION_GH", "SHOULD_SEE_TOP_NOW_CONTENT_MERCH_LIVE_OPS_GH", + "SHOULD_NOT_SEE_NOW_CONTENT_NH", + "SHOULD_SEE_NOW_CONTENT_NH_K1", + "SHOULD_SEE_NOW_CONTENT_NH_K2", + "SHOULD_SEE_NOW_CONTENT_NH_K3_4", + "SHOULD_SEE_NOW_CONTENT_NH_GTE_K5", + "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_K1", + "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_K2", + "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_K3_4", + "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_GTE_K5", + "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_K1", + "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_K2", + "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_K3_4", + "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_GTE_K5", + "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_K1", + "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_K2", + "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_K3_4", + "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_GTE_K5", + "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_K1", + "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_K2", + "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_K3_4", + "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_GTE_K5", + "SHOULD_NOT_SEE_NOW_CLUSTER_CONTENT_NH", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_K1", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_K2", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_K3_4", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_GTE_K5", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_K1", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_K2", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_K3_4", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_GTE_K5", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_K1", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_K2", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_K3_4", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_GTE_K5", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_K1", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_K2", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_K3_4", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_GTE_K5", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_K1", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_K2", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_K3_4", + "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_GTE_K5", "WALLET_WELLBEING_ALERT_SESSION_LEVEL", "BROAD_INTENT_REWEIGHTING_SESSION_LEVEL", "DYNASTY_DEVICE_HANDOFF_SESSION_LEVEL", @@ -112579,6 +112818,7 @@ "USER_P13N_SETTING_OFF_AT_SESSION_LEVEL", "BOOKS_USER_P13N_SETTING_OFF_AT_SESSION_LEVEL", "BATTLESTAR_GAME_IN_MDP_SESSION_LEVEL", + "BATTLESTAR_PSEUDO_CREDIT_OFFER_IN_DP_SESSION_LEVEL", "REVIEW_HIGHLIGHTS_SESSION_LEVEL", "BOOKS_NOTIFICATION_RECEIVED_SESSION_LEVEL", "LANGUAGE_SWITCHER_ELIGIBLE_SESSION_LEVEL", @@ -112663,6 +112903,9 @@ "IN_APP_OFFER_APP_4_AT_USER_LEVEL", "IN_APP_OFFER_BATTLESTAR_APP_GAMELOFT_AT_USER_LEVEL", "IN_APP_OFFER_BATTLESTAR_APP_EVONY_AT_USER_LEVEL", + "IN_APP_OFFER_BATTLESTAR_APP_ASPHALT_9_AT_USER_LEVEL", + "IN_APP_OFFER_BATTLESTAR_APP_MAGIC_RAMPAGE_AT_USER_LEVEL", + "IN_APP_OFFER_BATTLESTAR_APP_SUMMONERS_WAR_AT_USER_LEVEL", "IN_APP_OFFER_ELIGIBLE_AT_USER_LEVEL", "IN_APP_OFFER_ELIGIBLE_APP_1_AT_USER_LEVEL", "IN_APP_OFFER_ELIGIBLE_APP_2_AT_USER_LEVEL", @@ -112670,6 +112913,9 @@ "IN_APP_OFFER_ELIGIBLE_APP_4_AT_USER_LEVEL", "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_GAMELOFT_AT_USER_LEVEL", "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_EVONY_AT_USER_LEVEL", + "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_ASPHALT_9_AT_USER_LEVEL", + "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_MAGIC_RAMPAGE_AT_USER_LEVEL", + "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_SUMMONERS_WAR_AT_USER_LEVEL", "IN_APP_OFFER_SAVED_AT_USER_LEVEL", "IN_APP_OFFER_SAVED_APP_1_AT_USER_LEVEL", "IN_APP_OFFER_SAVED_APP_2_AT_USER_LEVEL", @@ -112755,6 +113001,7 @@ "GROWTH_CORPUS_WIDE_STAMP_CARD_GAMES_HOME_SERVER_USER_LEVEL", "LOYALTY_PURCHASE_QUEST_GAMES_HOME_SERVER_USER_LEVEL", "LOYALTY_CORPUS_WIDE_STAMP_CARD_GAMES_HOME_SERVER_USER_LEVEL", + "LOYALTY_CORPUS_WIDE_STAMP_CARD_DETAILS_PAGE_SERVER_USER_LEVEL", "SUBS_HIGH_CHURN_FOP_OPTIONS_AVAILABLE_USER_LEVEL", "SUBS_HIGH_CHURN_FOP_OPTIONS_AVAILABLE_USER_LEVEL_V2", "SUBS_HIGH_CHURN_FOP_OPTIONS_AVAILABLE_WITH_EXISTING_FOP_USER_LEVEL", @@ -113126,6 +113373,7 @@ "Event-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_OFF.", "", "Event-level test code corresponding to an MDP showing for a game also available on Battlestar.", + "Event-level test code corresponding to the details page ribbon showing a pseudo credit offer promotion for Battlestar games.", "Event-level test code to track triggering of review highlights.", "Event-level test code to track triggering of VPN Intent trusted vertical message.", "Event-level test code to track triggering of LOAN Intent trusted vertical message.", @@ -113134,6 +113382,9 @@ "Test code for MDP query event level.", "Test code for non-MDP query event level.", "Test code for nav card at event level.", + "Event-level test code for logging MDP LiveOps shown to ever-installed users on SERP", + "Event-level test code for logging MDP LiveOps shown to never-installed users on SERP", + "Broad Related Queries TestCode", "", "", "", @@ -113313,6 +113564,12 @@ "", "", "", + "", + "", + "", + "", + "", + "", "see go/reordering-subnav-tabs", "see go/reordering-subnav-tabs", "", @@ -113594,6 +113851,48 @@ "Merch featuring Now! content on Top of Games Home.", "", "", + "Session level test codes for Now! Home content coverage metrics. Any Now! content on NOW! Home.", + "", + "", + "", + "", + "New release Now! content on NOW! Home.", + "", + "", + "", + "Editorial Now! content on NOW! Home.", + "", + "", + "", + "Live Ops Now! content on NOW! Home.", + "", + "", + "", + "Pre-registration Now! content on NOW! Home.", + "", + "", + "", + "Session level test codes for Now! Cluster content coverage metrics on Now! Home Any Now! cluster content on Now! Home", + "", + "", + "", + "", + "New release Now! content on NOW! Home.", + "", + "", + "", + "Editorial Now! content on NOW! Home.", + "", + "", + "", + "Live Ops Now! content on NOW! Home.", + "", + "", + "", + "Pre-registration Now! content on NOW! Home.", + "", + "", + "", "TestCode for slicing the users cohorts that should have received a budget Warning alert", "TestCode for Broad Intent Reweighting Session Level.", "TestCode for Dynasty Device Handoff Session Level.", @@ -113712,6 +114011,7 @@ "Session-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_OFF.", "", "Session-level test code corresponding to an MDP showing for a game also available on Battlestar.", + "Session-level test code corresponding to the details page ribbon showing a pseudo credit offer promotion for Battlestar games.", "Session-level test code for review highlights", "Session level test code for users who receive a Books notification.", "Session level test code indicating that the user is eligible for language switcher on cart screen.", @@ -113810,6 +114110,12 @@ "", "", "", + "", + "", + "", + "", + "", + "", "User saw/would have seen the subscription one time pass offer", "", "", @@ -113888,6 +114194,7 @@ "User level test code for Corpus Wide Growth Stamp Card, for tracking users who are eligible for the GSC in Games Home. This test code is logged on server side.", "User level test code for Loyalty Purchase Quest, for tracking users who are eligible for the LPQ in Games Home. This test code is logged on server side.", "User level test code for Corpus Wide Loyalty Stamp Card, for tracking users who are eligible for the LSC in Games Home. This test code is logged on server side.", + "User level test code for Corpus Wide Loyalty Stamp Card, for tracking users who are eligible for the LSC in Apps Details Page. This test code is logged on server side.", "User level test code that indicates that at least one high churn fop options is available for user when visiting add fop page for subscription purchase. Deprecated, use 20361 instead.", "", "", @@ -115640,6 +115947,7 @@ "ADSBURST_DISCOVERY_UNCOMFORTABLE_V1", "ADSBURST_DISCOVERY_NERV_SUBS_V1", "ADSBURST_BASIC_TEXT_TOWER_V0", + "ADSBURST_V2", "SHOPPING_IMAGE_TRANSFORMATION_UNCROP", "SHOPPING_IMAGE_TRANSFORMATION_V2", "SCREENAI_V1", @@ -115745,6 +116053,7 @@ "", "", "", + "", "Shopping image transformation versions.", "", "ScreenAI versions. IconNet.", diff --git a/contentwarehouse/v1/contentwarehouse-gen.go b/contentwarehouse/v1/contentwarehouse-gen.go index 5cdf6d00781..2b0a737a5c0 100644 --- a/contentwarehouse/v1/contentwarehouse-gen.go +++ b/contentwarehouse/v1/contentwarehouse-gen.go @@ -3218,6 +3218,7 @@ type AppsPeopleOzExternalMergedpeopleapiAffinity struct { // "DRIVE_SEARCH_FILTER_PERSON_ONLY" // "ACCESSIBILITY_TRACKER_AFFINITY" // "PLX_DATASOURCE_AFFINITY" + // "DUCKIEWEB_AFFINITY" AffinityType string `json:"affinityType,omitempty"` // ContainerId: The ID of the container @@ -11094,8 +11095,6 @@ type AssistantApiCallCapabilities struct { // "VOICEMAIL" SupportedRecipientTypes []string `json:"supportedRecipientTypes,omitempty"` - // SupportsDuoEmailEndpoint: Whether the surface supports Duo calling - // email endpoints. SupportsDuoEmailEndpoint bool `json:"supportsDuoEmailEndpoint,omitempty"` // ForceSendFields is a list of field names (e.g. "CallFormats") to @@ -11500,6 +11499,8 @@ type AssistantApiClientOpPropertiesDeviceModifySettingClientOpProperty struct { // "AUTO_ROTATE" // "AUTO_ROTATE_FACE_DETECTION" // "BACKUP" + // "BATTERY_HEALTH" - Denotes if the battery health is normal / + // reduced / unknown. // "BATTERY_LEVEL" // "BATTERY_LOW" // "BATTERY_PERCENTAGE" @@ -11763,6 +11764,14 @@ type AssistantApiClientOpPropertiesDeviceModifySettingClientOpProperty struct { // "TIPS_AND_SUPPORT" - Settings > Tips & support // "SCREEN_ATTENTION" - Display > Screen timeout > Screen attention // "BLUETOOTH_TETHERING" + // "ALL_APPS" + // "EXTEND_UNLOCK" + // "CLEAR_CALLING" + // "GOOGLE_SETTINGS" + // "APP_LANGUAGES" + // "SIM_STATUS" + // "MICROPHONE_PERMISSIONS" - Permission Manager > Microphone + // "GOOGLE_PLAY_UPDATE" // "ABOUT_PHONE" - Begin of NGA proto consistence // "ACCOUNTS" // "APPLICATION" @@ -16027,11 +16036,6 @@ func (s *AssistantApiLocationCapabilities) MarshalJSON() ([]byte, error) { // debugging. Servers MUST NOT use this for any other purposes, such as // branching on it. Next ID: 16 type AssistantApiLoggingOnlyData struct { - // AccountIndex: The index of the account on the device. Useful when - // there are multiple accounts on a device. There is no guarantee that - // this is a stable number but is relatively stable in practice. - AccountIndex int64 `json:"accountIndex,omitempty"` - // AcpVersion: A user-readable string describing the ACP version // (go/acp-version) of the client app used by the user to originate the // conversation. @@ -16119,7 +16123,7 @@ type AssistantApiLoggingOnlyData struct { // "eng-no-update", etc. VirtualReleaseChannel string `json:"virtualReleaseChannel,omitempty"` - // ForceSendFields is a list of field names (e.g. "AccountIndex") to + // ForceSendFields is a list of field names (e.g. "AcpVersion") 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 @@ -16127,10 +16131,10 @@ type AssistantApiLoggingOnlyData struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AccountIndex") 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 + // NullFields is a list of field names (e.g. "AcpVersion") 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:"-"` @@ -16793,12 +16797,6 @@ type AssistantApiProactiveOutput struct { // proactive settings. PhotosProactive string `json:"photosProactive,omitempty"` - // SupportsProactiveOutput: Whether a device supports proactive output. - // Note that this is assumed to be true for all Smart Display devices, - // but surfaces that newly start supporting proactive_output should set - // this bit. - SupportsProactiveOutput bool `json:"supportsProactiveOutput,omitempty"` - // UserMatchProactive: Settings for displaying personal data on // proactive surfaces with face match capability. // @@ -21439,6 +21437,118 @@ func (s *AssistantContextProviderId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AssistantContextProviderSelectionPolicy: Identifies a business policy +// used for selecting a given content provider in the form of a name and +// a resulting scoring action. +type AssistantContextProviderSelectionPolicy struct { + // PolicyAction: Result of applying the policy. + // + // Possible values: + // "UNSET_ACTION" + // "BOOST_TO_WIN_ACTION" + // "SUPPRESS_TO_INVALIDATE_ACTION" + PolicyAction string `json:"policyAction,omitempty"` + + // PolicyName: Name of the policy. + // + // Possible values: + // "UNSET_POLICY" + // "QUERY_RESTRICTED_SPOTIFY_POLICY" - Candidate should win if the + // provider_id is Spotify, and the query specified to play the content + // on Spotify. See go/sp-policy-spotify. + // "QUERY_RESTRICTED_PANDORA_POLICY" - Candidate should win if the + // provider_id is Pandora, and the query specified to play the content + // on Pandora. See go/sp-policy-pandora. + // "QUERY_RESTRICTED_NETFLIX_POLICY" - Candidate should win if the + // provider_id is Netflix, and the query specified to play the content + // on Netflix. See go/sp-policy-netflix. + PolicyName string `json:"policyName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PolicyAction") 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. "PolicyAction") 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 *AssistantContextProviderSelectionPolicy) MarshalJSON() ([]byte, error) { + type NoMethod AssistantContextProviderSelectionPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// AssistantContextProviderSelectionResult: Message that gets returned +// from the Provider Selection Library (PSL). It encodes the scores, +// applied policies, and pruning decisions for a given provider +// candidate. +type AssistantContextProviderSelectionResult struct { + // BucketedFinalScore: Alternative bucketed score for use by downstream + // ranking providers. A raw numeric score is subject to semantic-drift, + // while a bucket is not. + // + // Possible values: + // "DEFAULT_BUCKET" + BucketedFinalScore string `json:"bucketedFinalScore,omitempty"` + + // FinalScore: Final score in the range [0,1] that can be used for + // ranking providers. Incorporates both policy rules and quality + // considerations. + FinalScore float64 `json:"finalScore,omitempty"` + + // PolicyApplied: List of business policies applied to the candidate. + PolicyApplied []*AssistantContextProviderSelectionPolicy `json:"policyApplied,omitempty"` + + // ShouldPrune: Indicates whether the candidate should be pruned. + ShouldPrune bool `json:"shouldPrune,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BucketedFinalScore") + // 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. "BucketedFinalScore") 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 *AssistantContextProviderSelectionResult) MarshalJSON() ([]byte, error) { + type NoMethod AssistantContextProviderSelectionResult + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *AssistantContextProviderSelectionResult) UnmarshalJSON(data []byte) error { + type NoMethod AssistantContextProviderSelectionResult + var s1 struct { + FinalScore gensupport.JSONFloat64 `json:"finalScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.FinalScore = float64(s1.FinalScore) + return nil +} + // AssistantContextProviderVariant: Note: As of May 2021, multiple // providers use the same mids (e.g. YouTube Main, YouTube Go, and // YouTube Music all have the same mids). However, quite often we end up @@ -21573,6 +21683,8 @@ type AssistantDeviceTargetingDeviceTargetingError struct { // propertries requirement specific (lock/unlock, etc) for hybrid // devices (such as Tangor). // "NO_NEARBY_DEVICES" - No nearby hearing devices + // "NO_MATCHING_LAST_USED_DEVICE" - No matching device for the + // LastUsedDevice requirement found. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Type") to @@ -22680,6 +22792,79 @@ func (s *AssistantDevicesPlatformProtoUnderstandingConfig) MarshalJSON() ([]byte return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AssistantGroundingProviderProviderSignalResult: Message containing +// the processed provider signals. This message is consumed by systems +// outside of the Provider GP, such as the HGR. For use of provider +// signals within the Provider GP, please refer to the CTF-governed +// PackedProviderSignals defined in: +// cs/google3/assistant/context/proto/packed_provider_signals.proto;rcl=4 +// 86224300;l=68 +type AssistantGroundingProviderProviderSignalResult struct { + // IsDefaultProvider: Whether the provider is the default provider for + // the BII and entity type. Also known as the 'preferred_provider'. + IsDefaultProvider bool `json:"isDefaultProvider,omitempty"` + + // IsForegroundProvider: Whether the provider is currently open in the + // foreground on the device. + IsForegroundProvider bool `json:"isForegroundProvider,omitempty"` + + // IsInAppProvider: Indicates that fulfillment on this provider will + // happen within the provider app + IsInAppProvider bool `json:"isInAppProvider,omitempty"` + + // IsInstalled: Whether the provider is installed, or otherwise + // reachable, from the device. + IsInstalled bool `json:"isInstalled,omitempty"` + + // IsLastUsedProvider: Whether the provider was the last-used provider + // for this intent on the device. Also known as the 'sticky_provider'. + IsLastUsedProvider bool `json:"isLastUsedProvider,omitempty"` + + // IsQueryRestrictedProvider: Whether the provider was specified by the + // query. + IsQueryRestrictedProvider bool `json:"isQueryRestrictedProvider,omitempty"` + + // ProviderSelectionResult: The result of running provider-selection on + // the provider candidate. This is populated by the Signal Extractor + // after the PSL has been run. + ProviderSelectionResult *AssistantContextProviderSelectionResult `json:"providerSelectionResult,omitempty"` + + // ProviderTypeSignal: Contains the "fulfillment type" of provider eg + // whether it's 0p or System API provider. + // + // Possible values: + // "UNKNOWN_TYPE" + // "ZEROTH_PARTY_TYPE" - Provider fulfillment is through 0-party + // assistant app (AGSA) on mobile or 0-party libassistant on other + // surfaces. See go/0p-and-system-api-in-pc. + // "ANDROID_SYSTEM_API_TYPE" - Provider fulfillment is through Android + // System API. See go/0p-and-system-api-in-pc. + ProviderTypeSignal string `json:"providerTypeSignal,omitempty"` + + // ForceSendFields is a list of field names (e.g. "IsDefaultProvider") + // 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. "IsDefaultProvider") 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 *AssistantGroundingProviderProviderSignalResult) MarshalJSON() ([]byte, error) { + type NoMethod AssistantGroundingProviderProviderSignalResult + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type AssistantGroundingRankerAssistantInteractionFeatures struct { TimeDecayed14dHalfLife float64 `json:"timeDecayed14dHalfLife,omitempty"` @@ -23702,12 +23887,8 @@ func (s *AssistantGroundingRankerPodcastGroundingProviderFeatures) UnmarshalJSON } // AssistantGroundingRankerProviderGroundingProviderFeatures: Features -// to be extracted from Provider GP for ranking in HGR. Next ID: 6 +// to be extracted from Provider GP for ranking in HGR. Next ID: 7 type AssistantGroundingRankerProviderGroundingProviderFeatures struct { - // IsInAppProvider: Indicates that fulfillment on this provider will - // happen within the provider app. - IsInAppProvider bool `json:"isInAppProvider,omitempty"` - // ProviderClusterIds: Cluster IDs for the provider. This field is // repeated because some providers can be associated with multiple // clusters. PRR specific feature. @@ -23717,20 +23898,23 @@ type AssistantGroundingRankerProviderGroundingProviderFeatures struct { // specific feature. ProviderId *AssistantContextProviderId `json:"providerId,omitempty"` + // ProviderSignalResult: Provider signals extracted from Provider GP. + ProviderSignalResult *AssistantGroundingProviderProviderSignalResult `json:"providerSignalResult,omitempty"` + // PslScore: Provider quality score in the range [0,1] that can be used // for ranking providers. Incorporates both policy rules and quality // considerations. PslScore float64 `json:"pslScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "IsInAppProvider") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "ProviderClusterIds") + // 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. "IsInAppProvider") to + // NullFields is a list of field names (e.g. "ProviderClusterIds") 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 @@ -24536,6 +24720,7 @@ type AssistantLogsDeviceInfoLog struct { // "HYBRID_DEVICE_PROPERTIES_FILTER" // "NEARBY_DEVICE_FILTER" // "DEVICE_ATTRIBUTES_FILTER" + // "LAST_USED_DEVICE_FILTER" // "DEFAULT_MEDIA_OUTPUT_PROMOTER" - promoters // "DEVICE_GROUP_PROMOTER" // "LOCAL_DEVICE_PROMOTER" @@ -25024,6 +25209,8 @@ type AssistantLogsDeviceSelectionResultLog struct { // propertries requirement specific (lock/unlock, etc) for hybrid // devices (such as Tangor). // "NO_NEARBY_DEVICES" - No nearby hearing devices + // "NO_MATCHING_LAST_USED_DEVICE" - No matching device for the + // LastUsedDevice requirement found. DeviceTargetingErrorType string `json:"deviceTargetingErrorType,omitempty"` // FinalLumosStage: The class name for the final filter/promoter used by @@ -25295,6 +25482,7 @@ type AssistantLogsLumosProcessorInfo struct { // "HYBRID_DEVICE_PROPERTIES_FILTER" // "NEARBY_DEVICE_FILTER" // "DEVICE_ATTRIBUTES_FILTER" + // "LAST_USED_DEVICE_FILTER" // "DEFAULT_MEDIA_OUTPUT_PROMOTER" - promoters // "DEVICE_GROUP_PROMOTER" // "LOCAL_DEVICE_PROMOTER" @@ -25986,7 +26174,7 @@ func (s *AssistantLogsTargetDeviceLog) MarshalJSON() ([]byte, error) { // AssistantPrefulfillmentRankerPrefulfillmentSignals: Signals to be // used by the Prefulfillment Ranker. Derived from the ParsingSignals // and GroundingSignals carried by the FunctionCall. LINT.IfChange Next -// ID: 55 +// ID: 57 type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // BindingSetAuis: Assistant User Interaction Score for binding set. BindingSetAuis float64 `json:"bindingSetAuis,omitempty"` @@ -26102,9 +26290,16 @@ type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // IsPodcastIntent: Whether the intent is a podcast intent. IsPodcastIntent bool `json:"isPodcastIntent,omitempty"` + // IsSageIntent: Whether this intent was generated by Sage. + IsSageIntent bool `json:"isSageIntent,omitempty"` + // IsTvmIntent: Whether the intent is a media object tvm intent. IsTvmIntent bool `json:"isTvmIntent,omitempty"` + // IsValidSmarthomeIntent: Whether the intent is a Smarthome-domain + // intent with valid device arguments. + IsValidSmarthomeIntent bool `json:"isValidSmarthomeIntent,omitempty"` + // IsVideoIntent: Whether the intent is a media object video intent. IsVideoIntent bool `json:"isVideoIntent,omitempty"` @@ -28560,6 +28755,10 @@ type BlueGingerClientVisibleProtoBlueGingerSupportedServicesBlueGingerModule str // module for GLS integration. // "GET_HUMAN" - Get Human bot. // "CHECK_INSURANCE_ACCEPTANCE" - Check health insurance acceptance. + // "FREE_TEXT" - Wrapper use case for creating an errand from + // conversational free-text. The true use case for the errand will be + // provided by a call to the LBT backend's task routing logic, such that + // this use case should NOT actually ever reach the caller. UseCase string `json:"useCase,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -50467,6 +50666,10 @@ type GeostoreRestrictionProto struct { // RestrictionGroup: Restriction group this restriction belongs to. RestrictionGroup *GeostoreFeatureIdProto `json:"restrictionGroup,omitempty"` + // RestrictionToken: A token that can be used to identify the version of + // the data about this restriction. + RestrictionToken string `json:"restrictionToken,omitempty"` + // Schedule: When specified, restriction applies only at particular // times (operating hours or times of the year: reversing lanes, // seasonal roads, no left turns from 3-5pm Mon-Fri except holidays). @@ -56560,6 +56763,9 @@ type GoogleAssistantEmbeddedV1Alarms struct { // fetching state (i.e. success). // "STATE_FETCH_ERROR_TIMEOUT" - The time taken to fetch state // exceeded the allowed maximum time. + // "STATE_FETCH_ERROR_UNSUPPORTED" - State fetch is not supported in + // Stateless Timer/Alarm Integration. This is expected for Stateless + // Integration. StateFetchError string `json:"stateFetchError,omitempty"` // ForceSendFields is a list of field names (e.g. "Alarms") to @@ -56963,6 +57169,9 @@ type GoogleAssistantEmbeddedV1Timers struct { // fetching state (i.e. success). // "STATE_FETCH_ERROR_TIMEOUT" - The time taken to fetch state // exceeded the allowed maximum time. + // "STATE_FETCH_ERROR_UNSUPPORTED" - State fetch is not supported in + // Stateless Timer/Alarm Integration. This is expected for Stateless + // Integration. StateFetchError string `json:"stateFetchError,omitempty"` // Timers: Information about all on-device timers. @@ -58474,6 +58683,10 @@ type GoogleCloudContentwarehouseV1InitializeProjectRequest struct { // contentwarehouse.googleapis.com/documentViewer. DocumentCreatorDefaultRole string `json:"documentCreatorDefaultRole,omitempty"` + // EnableCalUserEmailLogging: Optional. Whether to enable CAL user email + // logging. + EnableCalUserEmailLogging bool `json:"enableCalUserEmailLogging,omitempty"` + // KmsKey: Optional. The KMS key used for CMEK encryption. It is // required that the kms key is in the same region as the endpoint. The // same key will be used for all provisioned resources, if encryption is @@ -59570,6 +59783,8 @@ type GoogleCloudContentwarehouseV1Rule struct { // "UNKNOWN" - Trigger for unknown action. // "ON_CREATE" - Trigger for create document action. // "ON_UPDATE" - Trigger for update document action. + // "ON_CREATE_LINK" - Trigger for create link action. + // "ON_DELETE_LINK" - Trigger for delete link action. TriggerType string `json:"triggerType,omitempty"` // ForceSendFields is a list of field names (e.g. "Actions") to @@ -64136,7 +64351,7 @@ func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, @@ -73819,30 +74034,36 @@ func (s *IndexingDocjoinerCDocBuildInfo) MarshalJSON() ([]byte, error) { type IndexingDocjoinerDataVersion struct { AcceleratedShoppingSignal *IndexingDocjoinerDataVersionVersionInfo `json:"acceleratedShoppingSignal,omitempty"` + AuthenticSiteRankData *IndexingDocjoinerDataVersionVersionInfo `json:"authenticSiteRankData,omitempty"` + ChromeCounts *IndexingDocjoinerDataVersionVersionInfo `json:"chromeCounts,omitempty"` Creator *IndexingDocjoinerDataVersionVersionInfo `json:"creator,omitempty"` - // DiscoverSource: - // LINT.ThenChange(//depot/google3/indexing/ames/spanner/schema/web-versi - // on.proto) DiscoverSource *IndexingDocjoinerDataVersionVersionInfo `json:"discoverSource,omitempty"` Discussion *IndexingDocjoinerDataVersionVersionInfo `json:"discussion,omitempty"` DocumentIntent *IndexingDocjoinerDataVersionVersionInfo `json:"documentIntent,omitempty"` + ExtractedBookInfo *IndexingDocjoinerDataVersionVersionInfo `json:"extractedBookInfo,omitempty"` + + InstantChromeViews *IndexingDocjoinerDataVersionVersionInfo `json:"instantChromeViews,omitempty"` + InstantNavboost *IndexingDocjoinerDataVersionVersionInfo `json:"instantNavboost,omitempty"` Localyp *IndexingDocjoinerDataVersionVersionInfo `json:"localyp,omitempty"` ModernFormatContent *IndexingDocjoinerDataVersionVersionInfo `json:"modernFormatContent,omitempty"` - // Navboost: LINT.IfChange Navboost *IndexingDocjoinerDataVersionVersionInfo `json:"navboost,omitempty"` + PredictedAuthenticity *IndexingDocjoinerDataVersionVersionInfo `json:"predictedAuthenticity,omitempty"` + Rankembed *IndexingDocjoinerDataVersionVersionInfo `json:"rankembed,omitempty"` + RosettaLanguage *IndexingDocjoinerDataVersionVersionInfo `json:"rosettaLanguage,omitempty"` + UniversalFacts *IndexingDocjoinerDataVersionVersionInfo `json:"universalFacts,omitempty"` VideoScoringSignal *IndexingDocjoinerDataVersionVersionInfo `json:"videoScoringSignal,omitempty"` @@ -102453,6 +102674,8 @@ type PeoplestackFlexorgsProtoInternalExternal struct { // "PMW_TI" - Pmw Ti Team contact: pmw-ti // "ACCESSIBILITY_TRACKER" - Accessibility Tracker Team contact: // a11y-tracker-eng@google.com + // "DUCKIEWEB" - Duckieweb Team contact: + // workflow-horizontals-core@google.com // "DEPRECATED_QUICKSTART_FLUME" // "DUO_CLIENT" - Duo Client Team contact: duo-eng@google.com // "ALBERT" - Project albert (go/albert-frontend) Team contact: @@ -107866,10 +108089,13 @@ type QualityActionsReminder struct { // "DISCOVERY_SPARKS" - go/habits-sparks-design // "SPOKEN_NOTIFICATIONS_OOBE_OPTIN" - Notification for Spoken // Notifications OOBE opt-in. go/mapa-notifications-prd - // "PROACTIVE_TRAIN_STATUS" - Notifications for Train Journeys + // "SPOKEN_NOTIFICATIONS_BNS_MIGRATION_OOBE" - Notification for Spoken + // Notifications BNS Migration OOBE. + // go/bns-mapa-migration-notifications-prd + // "TRAIN_STATUS" - Notifications for Train Journeys // go/proactive-assistant-india-mvp - // "PROACTIVE_TRAIN_DELAY" - // "PROACTIVE_TRAIN_PLATFORM" + // "TRAIN_DELAY" + // "TRAIN_PLATFORM" // "UNIT_TESTING" - NOTE: This should always stay at the bottom of the // list. AsyncInteractionType string `json:"asyncInteractionType,omitempty"` @@ -111476,9 +111702,10 @@ type QualityOrbitAsteroidBeltDocumentIntentScores struct { // the image (or if the image is itself a mugshot). // "CRIME" - Document intent representing whether a page is // crime-related (go/crime-demotion-in-image-search-dd) - // "SHOPPING_TOPN" - Document intent representing whether a page is - // recommending best shopping products fulfilling certain application - // (e.g. "best laptops for students"). See go/shopping_topn_orbit. + // "PRODUCT_TOPN" - Document intents that provide analysis, opinions + // of a list of top-recommended products, and focus on multiple specific + // products individually. See + // go/sdu-shopping-page-intro#heading=h.r7a5gewp8do. // "AUTHENTICITY" - AuthenticityScore for document. see go/astar-dd. // "INFORMATION_SOURCE_OTHER" - Document intents for various // information sources. They are used in Tangram Diversity. see @@ -111491,6 +111718,12 @@ type QualityOrbitAsteroidBeltDocumentIntentScores struct { // "INFORMATION_SOURCE_RESEARCH_INSTITUTE" // "QNA" - Question and Answer format discussion page. check // go/orbit-doc-intents for detailed intent description. + // "UGC_DISCUSSION" - Document intent for whether a page is a ugc + // discussion. For the definition, please see the furball template + // go/ugc-discussion-template. Note that this is semantically the union + // of QNA and FORUM doc level intents. For the reason why we want it to + // be a single intent, see + // https://docs.google.com/document/d/1Ka3qcMWLvNHCZMomekHXXTumr_9g_tcgJ0BD6ev1HI4/edit?resourcekey=0-8r1KcmFaOH11GBK_yfipHA // "RESERVED_FOR_NEW_ENUM_135" - ========== Enums for new intents // ========== Instructions: When adding a new intent, use the reserved // enum number from the start of this list, and add a new reserved enum @@ -111517,10 +111750,9 @@ type QualityOrbitAsteroidBeltDocumentIntentScores struct { // "RESERVED_FOR_NEW_ENUM_153" // "RESERVED_FOR_NEW_ENUM_154" // "RESERVED_FOR_NEW_ENUM_155" - // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_99" - ========== + // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100" - ========== // Enums for new large intents ========== Please ask orbit@ before using // these. - // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_101" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_102" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_103" @@ -111667,9 +111899,10 @@ type QualityOrbitAsteroidBeltDocumentIntentScores struct { // the image (or if the image is itself a mugshot). // "CRIME" - Document intent representing whether a page is // crime-related (go/crime-demotion-in-image-search-dd) - // "SHOPPING_TOPN" - Document intent representing whether a page is - // recommending best shopping products fulfilling certain application - // (e.g. "best laptops for students"). See go/shopping_topn_orbit. + // "PRODUCT_TOPN" - Document intents that provide analysis, opinions + // of a list of top-recommended products, and focus on multiple specific + // products individually. See + // go/sdu-shopping-page-intro#heading=h.r7a5gewp8do. // "AUTHENTICITY" - AuthenticityScore for document. see go/astar-dd. // "INFORMATION_SOURCE_OTHER" - Document intents for various // information sources. They are used in Tangram Diversity. see @@ -111682,6 +111915,12 @@ type QualityOrbitAsteroidBeltDocumentIntentScores struct { // "INFORMATION_SOURCE_RESEARCH_INSTITUTE" // "QNA" - Question and Answer format discussion page. check // go/orbit-doc-intents for detailed intent description. + // "UGC_DISCUSSION" - Document intent for whether a page is a ugc + // discussion. For the definition, please see the furball template + // go/ugc-discussion-template. Note that this is semantically the union + // of QNA and FORUM doc level intents. For the reason why we want it to + // be a single intent, see + // https://docs.google.com/document/d/1Ka3qcMWLvNHCZMomekHXXTumr_9g_tcgJ0BD6ev1HI4/edit?resourcekey=0-8r1KcmFaOH11GBK_yfipHA // "RESERVED_FOR_NEW_ENUM_135" - ========== Enums for new intents // ========== Instructions: When adding a new intent, use the reserved // enum number from the start of this list, and add a new reserved enum @@ -111708,10 +111947,9 @@ type QualityOrbitAsteroidBeltDocumentIntentScores struct { // "RESERVED_FOR_NEW_ENUM_153" // "RESERVED_FOR_NEW_ENUM_154" // "RESERVED_FOR_NEW_ENUM_155" - // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_99" - ========== + // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100" - ========== // Enums for new large intents ========== Please ask orbit@ before using // these. - // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_101" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_102" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_103" @@ -111884,9 +112122,10 @@ type QualityOrbitAsteroidBeltImageIntentScores struct { // the image (or if the image is itself a mugshot). // "CRIME" - Document intent representing whether a page is // crime-related (go/crime-demotion-in-image-search-dd) - // "SHOPPING_TOPN" - Document intent representing whether a page is - // recommending best shopping products fulfilling certain application - // (e.g. "best laptops for students"). See go/shopping_topn_orbit. + // "PRODUCT_TOPN" - Document intents that provide analysis, opinions + // of a list of top-recommended products, and focus on multiple specific + // products individually. See + // go/sdu-shopping-page-intro#heading=h.r7a5gewp8do. // "AUTHENTICITY" - AuthenticityScore for document. see go/astar-dd. // "INFORMATION_SOURCE_OTHER" - Document intents for various // information sources. They are used in Tangram Diversity. see @@ -111899,6 +112138,12 @@ type QualityOrbitAsteroidBeltImageIntentScores struct { // "INFORMATION_SOURCE_RESEARCH_INSTITUTE" // "QNA" - Question and Answer format discussion page. check // go/orbit-doc-intents for detailed intent description. + // "UGC_DISCUSSION" - Document intent for whether a page is a ugc + // discussion. For the definition, please see the furball template + // go/ugc-discussion-template. Note that this is semantically the union + // of QNA and FORUM doc level intents. For the reason why we want it to + // be a single intent, see + // https://docs.google.com/document/d/1Ka3qcMWLvNHCZMomekHXXTumr_9g_tcgJ0BD6ev1HI4/edit?resourcekey=0-8r1KcmFaOH11GBK_yfipHA // "RESERVED_FOR_NEW_ENUM_135" - ========== Enums for new intents // ========== Instructions: When adding a new intent, use the reserved // enum number from the start of this list, and add a new reserved enum @@ -111925,10 +112170,9 @@ type QualityOrbitAsteroidBeltImageIntentScores struct { // "RESERVED_FOR_NEW_ENUM_153" // "RESERVED_FOR_NEW_ENUM_154" // "RESERVED_FOR_NEW_ENUM_155" - // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_99" - ========== + // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100" - ========== // Enums for new large intents ========== Please ask orbit@ before using // these. - // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_100" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_101" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_102" // "RESERVED_FOR_NEW_ENUM_LARGE_PLEASE_ASK_ORBIT_103" @@ -121656,6 +121900,8 @@ type RepositoryWebrefLightweightTokensMatchedLightweightToken struct { // noun (see go/wordgraph/definiteness). // "INDEFINITE" - Articles or markers that express the indefiniteness // of a noun (see go/wordgraph/definiteness). + // "FEMININE_DETERMINER" - Determiners that mark *unambiguously* the + // feminine gender of the expression (e.g.: "*une* artiste") // "ABLATIVE" - Linguistic markers that express the movement from a // place (like the English preposition *from* in a sentence like "I came // *from* my place"). @@ -127488,7 +127734,7 @@ type ResearchScamNearestNeighborsNeighbor struct { // data, e.g. docid, URL, query string. Docid string `json:"docid,omitempty"` - // Gfv: The field isn't tpopulated by default, but when enabled (eg, in + // Gfv: The field isn't populated by default, but when enabled (eg, in // the ground-truth pipeline), this field provides the original database // GFV corresponding to this result. Gfv *ResearchScamGenericFeatureVector `json:"gfv,omitempty"` @@ -129897,6 +130143,10 @@ type ScienceCitation struct { // CitationSource: citation src: dblp/crossref/paper etc CitationSource int64 `json:"CitationSource,omitempty"` + // CitationSourceCrawlTimestamp: Seconds since the epoch, should be + // consistent with CitationSourceUrl. + CitationSourceCrawlTimestamp int64 `json:"CitationSourceCrawlTimestamp,omitempty,string"` + // CitationSourceUrl: url where record came from CitationSourceUrl string `json:"CitationSourceUrl,omitempty"` @@ -143328,6 +143578,9 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "BATTLESTAR_GAME_IN_MDP_EVENT_LEVEL" - Event-level test code // corresponding to an MDP showing for a game also available on // Battlestar. + // "BATTLESTAR_PSEUDO_CREDIT_OFFER_IN_DP_EVENT_LEVEL" - Event-level + // test code corresponding to the details page ribbon showing a pseudo + // credit offer promotion for Battlestar games. // "REVIEW_HIGHLIGHTS_TRIGGERING_EVENT_LEVEL" - Event-level test code // to track triggering of review highlights. // "TRUSTED_VERTICAL_VPN_INTENT_EVENT_LEVEL" - Event-level test code @@ -143342,6 +143595,14 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "QUERY_TYPE_NON_MDP_EVENT_LEVEL" - Test code for non-MDP query // event level. // "NAV_CARD_EVENT_LEVEL" - Test code for nav card at event level. + // "MDP_WITH_LIVE_OPS_EVER_INSTALLED_USERS_EVENT_LEVEL" - Event-level + // test code for logging MDP LiveOps shown to ever-installed users on + // SERP + // "MDP_WITH_LIVE_OPS_NEVER_INSTALLED_USERS_EVENT_LEVEL" - Event-level + // test code for logging MDP LiveOps shown to never-installed users on + // SERP + // "BROAD_RELATED_QUERIES_CLUSTER_EVENT" - Broad Related Queries + // TestCode // "EVENT_LEVEL_TEST_CODE_LIMIT" // "ENTERTAINMENT_CLUSTER_TRIGGERING_AT_SESSION_LEVEL" // "BEST_SELLER_CART_TAG_AT_SESSION_LEVEL" @@ -143532,6 +143793,9 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "IN_APP_OFFER_APP_4_AT_SESSION_LEVEL" // "IN_APP_OFFER_BATTLESTAR_APP_GAMELOFT_AT_SESSION_LEVEL" // "IN_APP_OFFER_BATTLESTAR_APP_EVONY_AT_SESSION_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_APP_ASPHALT_9_AT_SESSION_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_APP_MAGIC_RAMPAGE_AT_SESSION_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_APP_SUMMONERS_WAR_AT_SESSION_LEVEL" // "IN_APP_OFFER_ELIGIBLE_AT_SESSION_LEVEL" // "IN_APP_OFFER_ELIGIBLE_APP_1_AT_SESSION_LEVEL" // "IN_APP_OFFER_ELIGIBLE_APP_2_AT_SESSION_LEVEL" @@ -143539,6 +143803,11 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "IN_APP_OFFER_ELIGIBLE_APP_4_AT_SESSION_LEVEL" // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_GAMELOFT_AT_SESSION_LEVEL" // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_EVONY_AT_SESSION_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_ASPHALT_9_AT_SESSION_LEVEL" + // + // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_MAGIC_RAMPAGE_AT_SESSION_LEVEL" + // + // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_SUMMONERS_WAR_AT_SESSION_LEVEL" // "IN_APP_OFFER_SAVED_AT_SESSION_LEVEL" // "IN_APP_OFFER_SAVED_APP_1_AT_SESSION_LEVEL" // "IN_APP_OFFER_SAVED_APP_2_AT_SESSION_LEVEL" @@ -144011,6 +144280,59 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // Now! content on Top of Games Home. // "SHOULD_SEE_TOP_NOW_CONTENT_MERCH_PRE_REGISTRATION_GH" // "SHOULD_SEE_TOP_NOW_CONTENT_MERCH_LIVE_OPS_GH" + // "SHOULD_NOT_SEE_NOW_CONTENT_NH" - Session level test codes for Now! + // Home content coverage metrics. Any Now! content on NOW! Home. + // "SHOULD_SEE_NOW_CONTENT_NH_K1" + // "SHOULD_SEE_NOW_CONTENT_NH_K2" + // "SHOULD_SEE_NOW_CONTENT_NH_K3_4" + // "SHOULD_SEE_NOW_CONTENT_NH_GTE_K5" + // "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_K1" - New release Now! + // content on NOW! Home. + // "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_K2" + // "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_K3_4" + // "SHOULD_SEE_NOW_CONTENT_NEW_RELEASE_NH_GTE_K5" + // "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_K1" - Editorial Now! content + // on NOW! Home. + // "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_K2" + // "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_K3_4" + // "SHOULD_SEE_NOW_CONTENT_EDITORIAL_NH_GTE_K5" + // "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_K1" - Live Ops Now! content on + // NOW! Home. + // "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_K2" + // "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_K3_4" + // "SHOULD_SEE_NOW_CONTENT_LIVE_OPS_NH_GTE_K5" + // "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_K1" - Pre-registration + // Now! content on NOW! Home. + // "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_K2" + // "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_K3_4" + // "SHOULD_SEE_NOW_CONTENT_PRE_REGISTRATION_NH_GTE_K5" + // "SHOULD_NOT_SEE_NOW_CLUSTER_CONTENT_NH" - Session level test codes + // for Now! Cluster content coverage metrics on Now! Home Any Now! + // cluster content on Now! Home + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_K1" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_K2" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_K3_4" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NH_GTE_K5" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_K1" - New release + // Now! content on NOW! Home. + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_K2" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_K3_4" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_NEW_RELEASE_NH_GTE_K5" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_K1" - Editorial Now! + // content on NOW! Home. + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_K2" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_K3_4" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_EDITORIAL_NH_GTE_K5" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_K1" - Live Ops Now! + // content on NOW! Home. + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_K2" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_K3_4" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_LIVE_OPS_NH_GTE_K5" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_K1" - + // Pre-registration Now! content on NOW! Home. + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_K2" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_K3_4" + // "SHOULD_SEE_NOW_CLUSTER_CONTENT_PRE_REGISTRATION_NH_GTE_K5" // "WALLET_WELLBEING_ALERT_SESSION_LEVEL" - TestCode for slicing the // users cohorts that should have received a budget Warning alert // "BROAD_INTENT_REWEIGHTING_SESSION_LEVEL" - TestCode for Broad @@ -144241,6 +144563,9 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "BATTLESTAR_GAME_IN_MDP_SESSION_LEVEL" - Session-level test code // corresponding to an MDP showing for a game also available on // Battlestar. + // "BATTLESTAR_PSEUDO_CREDIT_OFFER_IN_DP_SESSION_LEVEL" - + // Session-level test code corresponding to the details page ribbon + // showing a pseudo credit offer promotion for Battlestar games. // "REVIEW_HIGHLIGHTS_SESSION_LEVEL" - Session-level test code for // review highlights // "BOOKS_NOTIFICATION_RECEIVED_SESSION_LEVEL" - Session level test @@ -144377,6 +144702,9 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "IN_APP_OFFER_APP_4_AT_USER_LEVEL" // "IN_APP_OFFER_BATTLESTAR_APP_GAMELOFT_AT_USER_LEVEL" // "IN_APP_OFFER_BATTLESTAR_APP_EVONY_AT_USER_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_APP_ASPHALT_9_AT_USER_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_APP_MAGIC_RAMPAGE_AT_USER_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_APP_SUMMONERS_WAR_AT_USER_LEVEL" // "IN_APP_OFFER_ELIGIBLE_AT_USER_LEVEL" // "IN_APP_OFFER_ELIGIBLE_APP_1_AT_USER_LEVEL" // "IN_APP_OFFER_ELIGIBLE_APP_2_AT_USER_LEVEL" @@ -144384,6 +144712,9 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "IN_APP_OFFER_ELIGIBLE_APP_4_AT_USER_LEVEL" // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_GAMELOFT_AT_USER_LEVEL" // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_EVONY_AT_USER_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_ASPHALT_9_AT_USER_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_MAGIC_RAMPAGE_AT_USER_LEVEL" + // "IN_APP_OFFER_BATTLESTAR_ELIGIBLE_APP_SUMMONERS_WAR_AT_USER_LEVEL" // "IN_APP_OFFER_SAVED_AT_USER_LEVEL" // "IN_APP_OFFER_SAVED_APP_1_AT_USER_LEVEL" // "IN_APP_OFFER_SAVED_APP_2_AT_USER_LEVEL" @@ -144540,6 +144871,10 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // User level test code for Corpus Wide Loyalty Stamp Card, for tracking // users who are eligible for the LSC in Games Home. This test code is // logged on server side. + // "LOYALTY_CORPUS_WIDE_STAMP_CARD_DETAILS_PAGE_SERVER_USER_LEVEL" - + // User level test code for Corpus Wide Loyalty Stamp Card, for tracking + // users who are eligible for the LSC in Apps Details Page. This test + // code is logged on server side. // "SUBS_HIGH_CHURN_FOP_OPTIONS_AVAILABLE_USER_LEVEL" - User level // test code that indicates that at least one high churn fop options is // available for user when visiting add fop page for subscription @@ -147310,6 +147645,7 @@ type VideoContentSearchFrameStarburstData struct { // "ADSBURST_DISCOVERY_UNCOMFORTABLE_V1" // "ADSBURST_DISCOVERY_NERV_SUBS_V1" // "ADSBURST_BASIC_TEXT_TOWER_V0" + // "ADSBURST_V2" // "SHOPPING_IMAGE_TRANSFORMATION_UNCROP" - Shopping image // transformation versions. // "SHOPPING_IMAGE_TRANSFORMATION_V2" diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index 0dcf2a5c615..69a7b73904a 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1042,7 +1042,7 @@ } } }, - "revision": "20230605", + "revision": "20230609", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -1336,7 +1336,7 @@ "properties": { "gcsManagedDocId": { "$ref": "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId", - "description": "A document id within user managed Cloud Storage." + "description": "A document id within user-managed Cloud Storage." }, "revisionRef": { "$ref": "GoogleCloudDocumentaiUiv1beta3RevisionRef", @@ -1350,7 +1350,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId": { - "description": "Identifies a document uniquely within the scope of a dataset in user managed Cloud Storage option.", + "description": "Identifies a document uniquely within the scope of a dataset in the user-managed Cloud Storage option.", "id": "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId", "properties": { "cwDocId": { @@ -1358,7 +1358,7 @@ "type": "string" }, "gcsUri": { - "description": "Required. The Cloud Storage uri where the actual document is stored.", + "description": "Required. The Cloud Storage URI where the actual document is stored.", "type": "string" } }, @@ -2004,7 +2004,7 @@ "description": "The input documents for the BatchProcessDocuments method." }, "skipHumanReview": { - "description": "Whether Human Review feature should be skipped for this request. Default to `false`.", + "description": "Whether human review should be skipped for this request. Default to `false`.", "type": "boolean" } }, @@ -2429,7 +2429,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1DocumentPageLayout", @@ -2705,7 +2705,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -2728,7 +2728,7 @@ "id": "GoogleCloudDocumentaiV1DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -3264,7 +3264,7 @@ "description": "If specified, lists all the possible values for this entity. This should not be more than a handful of values. If the number of values is \u003e10 or could change frequently use the `EntityType.value_ontology` field and specify a list of all possible values in a value ontology file." }, "name": { - "description": "Name of the type. It must be unique within the schema file and cannot be a \"Common Type\". The following naming conventions are used: - Use `snake_casing` - Name matching is case-sensitive - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.", + "description": "Name of the type. It must be unique within the schema file and cannot be a \"Common Type\". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.", "type": "string" }, "properties": { @@ -3418,7 +3418,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -3951,7 +3951,7 @@ "description": "A raw document content (bytes)." }, "skipHumanReview": { - "description": "Whether Human Review feature should be skipped for this request. Default to false.", + "description": "Whether human review should be skipped for this request. Default to `false`.", "type": "boolean" } }, @@ -3990,7 +3990,7 @@ "type": "string" }, "kmsKeyName": { - "description": "The [KMS key](https://cloud.google.com/security-key-management) used for encryption/decryption in CMEK scenarios.", + "description": "The [KMS key](https://cloud.google.com/security-key-management) used for encryption and decryption in CMEK scenarios.", "type": "string" }, "name": { @@ -4101,14 +4101,14 @@ "id": "GoogleCloudDocumentaiV1ProcessorTypeLocationInfo", "properties": { "locationId": { - "description": "The location id, refer to [regional and multi-regional support](/document-ai/docs/regions) for supported locations.", + "description": "The location ID. For supported locations, refer to [regional and multi-regional support](/document-ai/docs/regions).", "type": "string" } }, "type": "object" }, "GoogleCloudDocumentaiV1ProcessorVersion": { - "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pre-trained by Google internally or uptrained by the customer. At a time, a processor can only have one default version version. So the processor's behavior (when processing documents) is defined by a default version", + "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pretrained by Google internally or uptrained by the customer. A processor can only have one default version at a time. Its document-processing behavior is defined by that version.", "id": "GoogleCloudDocumentaiV1ProcessorVersion", "properties": { "createTime": { @@ -4736,7 +4736,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout", @@ -5012,7 +5012,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -5035,7 +5035,7 @@ "id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -5596,7 +5596,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -6114,7 +6114,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout", @@ -6390,7 +6390,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -6413,7 +6413,7 @@ "id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -6974,7 +6974,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -7775,7 +7775,7 @@ "type": "object" }, "GoogleTypeColor": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "GoogleTypeColor", "properties": { "alpha": { diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index 98f777e7fbb..b6e83eaf4e7 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -743,7 +743,7 @@ type GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse struct { // GoogleCloudDocumentaiUiv1beta3DocumentId: Document Identifier. type GoogleCloudDocumentaiUiv1beta3DocumentId struct { - // GcsManagedDocId: A document id within user managed Cloud Storage. + // GcsManagedDocId: A document id within user-managed Cloud Storage. GcsManagedDocId *GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId `json:"gcsManagedDocId,omitempty"` // RevisionRef: Points to a specific revision of the document if set. @@ -777,13 +777,13 @@ func (s *GoogleCloudDocumentaiUiv1beta3DocumentId) MarshalJSON() ([]byte, error) } // GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId: -// Identifies a document uniquely within the scope of a dataset in user -// managed Cloud Storage option. +// Identifies a document uniquely within the scope of a dataset in the +// user-managed Cloud Storage option. type GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId struct { // CwDocId: Id of the document (indexed) managed by Content Warehouse. CwDocId string `json:"cwDocId,omitempty"` - // GcsUri: Required. The Cloud Storage uri where the actual document is + // GcsUri: Required. The Cloud Storage URI where the actual document is // stored. GcsUri string `json:"gcsUri,omitempty"` @@ -2027,8 +2027,8 @@ type GoogleCloudDocumentaiV1BatchProcessRequest struct { // method. InputDocuments *GoogleCloudDocumentaiV1BatchDocumentsInputConfig `json:"inputDocuments,omitempty"` - // SkipHumanReview: Whether Human Review feature should be skipped for - // this request. Default to `false`. + // SkipHumanReview: Whether human review should be skipped for this + // request. Default to `false`. SkipHumanReview bool `json:"skipHumanReview,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2687,7 +2687,7 @@ type GoogleCloudDocumentaiV1DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -3120,8 +3120,8 @@ func (s *GoogleCloudDocumentaiV1DocumentPageImage) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1DocumentPageImageQualityScores: Image Quality -// Scores for the page image. +// GoogleCloudDocumentaiV1DocumentPageImageQualityScores: Image quality +// scores for the page image. type GoogleCloudDocumentaiV1DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -3172,7 +3172,7 @@ func (s *GoogleCloudDocumentaiV1DocumentPageImageQualityScores) UnmarshalJSON(da // Image Quality Defects type GoogleCloudDocumentaiV1DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -3993,10 +3993,10 @@ type GoogleCloudDocumentaiV1DocumentSchemaEntityType struct { // Name: Name of the type. It must be unique within the schema file and // cannot be a "Common Type". The following naming conventions are used: - // - Use `snake_casing` - Name matching is case-sensitive - Maximum 64 + // - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 // characters. - Must start with a letter. - Allowed characters: ASCII // letters `[a-z0-9_-]`. (For backward compatibility internal - // infrastructure and tooling can handle any ascii character) - The `/` + // infrastructure and tooling can handle any ascii character.) - The `/` // is sometimes used to denote a property of a type. For example // `line_item/amount`. This convention is deprecated, but will still be // honored for backward compatibility. @@ -4255,8 +4255,8 @@ type GoogleCloudDocumentaiV1DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -5277,8 +5277,8 @@ type GoogleCloudDocumentaiV1ProcessRequest struct { // RawDocument: A raw document content (bytes). RawDocument *GoogleCloudDocumentaiV1RawDocument `json:"rawDocument,omitempty"` - // SkipHumanReview: Whether Human Review feature should be skipped for - // this request. Default to false. + // SkipHumanReview: Whether human review should be skipped for this + // request. Default to `false`. SkipHumanReview bool `json:"skipHumanReview,omitempty"` // ForceSendFields is a list of field names (e.g. "FieldMask") to @@ -5357,7 +5357,7 @@ type GoogleCloudDocumentaiV1Processor struct { // KmsKeyName: The KMS key // (https://cloud.google.com/security-key-management) used for - // encryption/decryption in CMEK scenarios. + // encryption and decryption in CMEK scenarios. KmsKeyName string `json:"kmsKeyName,omitempty"` // Name: Output only. Immutable. The resource name of the processor. @@ -5522,8 +5522,8 @@ func (s *GoogleCloudDocumentaiV1ProcessorType) MarshalJSON() ([]byte, error) { // GoogleCloudDocumentaiV1ProcessorTypeLocationInfo: The location // information about where the processor is available. type GoogleCloudDocumentaiV1ProcessorTypeLocationInfo struct { - // LocationId: The location id, refer to regional and multi-regional - // support (/document-ai/docs/regions) for supported locations. + // LocationId: The location ID. For supported locations, refer to + // regional and multi-regional support (/document-ai/docs/regions). LocationId string `json:"locationId,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to @@ -5551,10 +5551,9 @@ func (s *GoogleCloudDocumentaiV1ProcessorTypeLocationInfo) MarshalJSON() ([]byte // GoogleCloudDocumentaiV1ProcessorVersion: A processor version is an // implementation of a processor. Each processor can have multiple -// versions, pre-trained by Google internally or uptrained by the -// customer. At a time, a processor can only have one default version -// version. So the processor's behavior (when processing documents) is -// defined by a default version +// versions, pretrained by Google internally or uptrained by the +// customer. A processor can only have one default version at a time. +// Its document-processing behavior is defined by that version. type GoogleCloudDocumentaiV1ProcessorVersion struct { // CreateTime: The time the processor version was created. CreateTime string `json:"createTime,omitempty"` @@ -6571,7 +6570,7 @@ type GoogleCloudDocumentaiV1beta1DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta1DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -7006,7 +7005,7 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -7057,7 +7056,7 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -7921,8 +7920,8 @@ type GoogleCloudDocumentaiV1beta1DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -8842,7 +8841,7 @@ type GoogleCloudDocumentaiV1beta2DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta2DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -9277,7 +9276,7 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -9328,7 +9327,7 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -10192,8 +10191,8 @@ type GoogleCloudDocumentaiV1beta2DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -11684,7 +11683,7 @@ func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, diff --git a/documentai/v1beta2/documentai-api.json b/documentai/v1beta2/documentai-api.json index 37f1656da5c..ee81dabc926 100644 --- a/documentai/v1beta2/documentai-api.json +++ b/documentai/v1beta2/documentai-api.json @@ -292,7 +292,7 @@ } } }, - "revision": "20230605", + "revision": "20230609", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -586,7 +586,7 @@ "properties": { "gcsManagedDocId": { "$ref": "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId", - "description": "A document id within user managed Cloud Storage." + "description": "A document id within user-managed Cloud Storage." }, "revisionRef": { "$ref": "GoogleCloudDocumentaiUiv1beta3RevisionRef", @@ -600,7 +600,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId": { - "description": "Identifies a document uniquely within the scope of a dataset in user managed Cloud Storage option.", + "description": "Identifies a document uniquely within the scope of a dataset in the user-managed Cloud Storage option.", "id": "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId", "properties": { "cwDocId": { @@ -608,7 +608,7 @@ "type": "string" }, "gcsUri": { - "description": "Required. The Cloud Storage uri where the actual document is stored.", + "description": "Required. The Cloud Storage URI where the actual document is stored.", "type": "string" } }, @@ -1810,7 +1810,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout", @@ -2086,7 +2086,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -2109,7 +2109,7 @@ "id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -2670,7 +2670,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -3213,7 +3213,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout", @@ -3489,7 +3489,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -3512,7 +3512,7 @@ "id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -4073,7 +4073,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -4961,7 +4961,7 @@ "type": "object" }, "GoogleTypeColor": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "GoogleTypeColor", "properties": { "alpha": { diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index 2b2f37fd50c..c2a178ee7c9 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -695,7 +695,7 @@ type GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse struct { // GoogleCloudDocumentaiUiv1beta3DocumentId: Document Identifier. type GoogleCloudDocumentaiUiv1beta3DocumentId struct { - // GcsManagedDocId: A document id within user managed Cloud Storage. + // GcsManagedDocId: A document id within user-managed Cloud Storage. GcsManagedDocId *GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId `json:"gcsManagedDocId,omitempty"` // RevisionRef: Points to a specific revision of the document if set. @@ -729,13 +729,13 @@ func (s *GoogleCloudDocumentaiUiv1beta3DocumentId) MarshalJSON() ([]byte, error) } // GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId: -// Identifies a document uniquely within the scope of a dataset in user -// managed Cloud Storage option. +// Identifies a document uniquely within the scope of a dataset in the +// user-managed Cloud Storage option. type GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId struct { // CwDocId: Id of the document (indexed) managed by Content Warehouse. CwDocId string `json:"cwDocId,omitempty"` - // GcsUri: Required. The Cloud Storage uri where the actual document is + // GcsUri: Required. The Cloud Storage URI where the actual document is // stored. GcsUri string `json:"gcsUri,omitempty"` @@ -2896,7 +2896,7 @@ type GoogleCloudDocumentaiV1beta1DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta1DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -3331,7 +3331,7 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -3382,7 +3382,7 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -4246,8 +4246,8 @@ type GoogleCloudDocumentaiV1beta1DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -5231,7 +5231,7 @@ type GoogleCloudDocumentaiV1beta2DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta2DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -5666,7 +5666,7 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -5717,7 +5717,7 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -6581,8 +6581,8 @@ type GoogleCloudDocumentaiV1beta2DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -8232,7 +8232,7 @@ func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index d369f2fba94..dde5d9fcddb 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -657,7 +657,7 @@ "dataset": { "methods": { "getDatasetSchema": { - "description": "Gets the DatasetSchema of a Dataset.", + "description": "Gets the `DatasetSchema` of a `Dataset`.", "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/dataset/datasetSchema", "httpMethod": "GET", "id": "documentai.projects.locations.processors.dataset.getDatasetSchema", @@ -687,7 +687,7 @@ ] }, "updateDatasetSchema": { - "description": "Updates a DatasetSchema.", + "description": "Updates a `DatasetSchema`.", "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/dataset/datasetSchema", "httpMethod": "PATCH", "id": "documentai.projects.locations.processors.dataset.updateDatasetSchema", @@ -1114,7 +1114,7 @@ } } }, - "revision": "20230605", + "revision": "20230609", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -1408,7 +1408,7 @@ "properties": { "gcsManagedDocId": { "$ref": "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId", - "description": "A document id within user managed Cloud Storage." + "description": "A document id within user-managed Cloud Storage." }, "revisionRef": { "$ref": "GoogleCloudDocumentaiUiv1beta3RevisionRef", @@ -1422,7 +1422,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId": { - "description": "Identifies a document uniquely within the scope of a dataset in user managed Cloud Storage option.", + "description": "Identifies a document uniquely within the scope of a dataset in the user-managed Cloud Storage option.", "id": "GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId", "properties": { "cwDocId": { @@ -1430,7 +1430,7 @@ "type": "string" }, "gcsUri": { - "description": "Required. The Cloud Storage uri where the actual document is stored.", + "description": "Required. The Cloud Storage URI where the actual document is stored.", "type": "string" } }, @@ -2632,7 +2632,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout", @@ -2908,7 +2908,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -2931,7 +2931,7 @@ "id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -3492,7 +3492,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -4010,7 +4010,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout", @@ -4286,7 +4286,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -4309,7 +4309,7 @@ "id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -4870,7 +4870,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -5220,7 +5220,7 @@ "description": "Inference-time options for the process API" }, "skipHumanReview": { - "description": "Whether Human Review feature should be skipped for this request. Default to `false`.", + "description": "Whether human review should be skipped for this request. Default to `false`.", "type": "boolean" } }, @@ -5330,11 +5330,11 @@ "properties": { "documentWarehouseConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig", - "description": "Optional. Document Warehouse-based dataset config." + "description": "Optional. Document AI Warehouse-based dataset configuration." }, "gcsManagedConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig", - "description": "Optional. User managed GCS dataset config. Use this config if the dataset documents are stored under a user managed GCS location." + "description": "Optional. User-managed Cloud Storage dataset configuration. Use this configuration if the dataset documents are stored under a user-managed Cloud Storage location." }, "name": { "description": "Dataset resource name. Format: `projects/{project}/locations/{location}/processors/{processor}/dataset`", @@ -5342,10 +5342,10 @@ }, "spannerIndexingConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig", - "description": "Optional. A lightweight indexing source with low latency and high reliability, but lack advanced features like CMEK and content based search." + "description": "Optional. A lightweight indexing source with low latency and high reliability, but lacking advanced features like CMEK and content-based search." }, "state": { - "description": "Required. State of the dataset. Will be ignored when updating dataset.", + "description": "Required. State of the dataset. Ignored when updating dataset.", "enum": [ "STATE_UNSPECIFIED", "UNINITIALIZED", @@ -5362,22 +5362,22 @@ }, "unmanagedDatasetConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig", - "description": "Optional. Unmanaged dataset config. Use this config if the dataset documents are managed by the document service internally (not user managed)." + "description": "Optional. Unmanaged dataset configuration. Use this configuration if the dataset documents are managed by the document service internally (not user-managed)." } }, "type": "object" }, "GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig": { - "description": "Config specific to the Document Warehouse-based implementation.", + "description": "Configuration specific to the Document AI Warehouse-based implementation.", "id": "GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig", "properties": { "collection": { - "description": "Output only. The collection in Document Warehouse associated with the dataset.", + "description": "Output only. The collection in Document AI Warehouse associated with the dataset.", "readOnly": true, "type": "string" }, "schema": { - "description": "Output only. The schema in Document Warehouse associated with the dataset.", + "description": "Output only. The schema in Document AI Warehouse associated with the dataset.", "readOnly": true, "type": "string" } @@ -5385,12 +5385,12 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig": { - "description": "Config specific to the GCS-based implementation.", + "description": "Configuration specific to the Cloud Storage-based implementation.", "id": "GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig", "properties": { "gcsPrefix": { "$ref": "GoogleCloudDocumentaiV1beta3GcsPrefix", - "description": "Required. The Cloud Storage uri (a directory) where the documents belonging to the dataset must be stored." + "description": "Required. The Cloud Storage URI (a directory) where the documents belonging to the dataset must be stored." } }, "type": "object" @@ -5411,13 +5411,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig": { - "description": "Config specific to spanner based indexing.", + "description": "Configuration specific to spanner-based indexing.", "id": "GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig": { - "description": "Config specific to unmanaged config", + "description": "Configuration specific to an unmanaged dataset.", "id": "GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig", "properties": {}, "type": "object" @@ -5769,7 +5769,7 @@ }, "imageQualityScores": { "$ref": "GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores", - "description": "Image Quality Scores." + "description": "Image quality scores." }, "layout": { "$ref": "GoogleCloudDocumentaiV1beta3DocumentPageLayout", @@ -6045,7 +6045,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores": { - "description": "Image Quality Scores for the page image.", + "description": "Image quality scores for the page image.", "id": "GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores", "properties": { "detectedDefects": { @@ -6068,7 +6068,7 @@ "id": "GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScoresDetectedDefect", "properties": { "confidence": { - "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence of that the defect exists.", + "description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.", "format": "float", "type": "number" }, @@ -6608,7 +6608,7 @@ "description": "If specified, lists all the possible values for this entity. This should not be more than a handful of values. If the number of values is \u003e10 or could change frequently use the `EntityType.value_ontology` field and specify a list of all possible values in a value ontology file." }, "name": { - "description": "Name of the type. It must be unique within the schema file and cannot be a \"Common Type\". The following naming conventions are used: - Use `snake_casing` - Name matching is case-sensitive - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.", + "description": "Name of the type. It must be unique within the schema file and cannot be a \"Common Type\". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.", "type": "string" }, "properties": { @@ -6766,7 +6766,7 @@ "type": "number" }, "unit": { - "description": "Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, etc.).", + "description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).", "type": "string" } }, @@ -6857,7 +6857,7 @@ "id": "GoogleCloudDocumentaiV1beta3EntityTypeMetadata", "properties": { "inactive": { - "description": "Whether the entity type should be considered as \"inactive\".", + "description": "Whether the entity type should be considered inactive.", "type": "boolean" } }, @@ -7410,7 +7410,7 @@ "description": "A raw document content (bytes)." }, "skipHumanReview": { - "description": "Whether Human Review feature should be skipped for this request. Default to false.", + "description": "Whether human review should be skipped for this request. Default to `false`.", "type": "boolean" } }, @@ -7453,7 +7453,7 @@ "type": "string" }, "kmsKeyName": { - "description": "The [KMS key](https://cloud.google.com/security-key-management) used for encryption/decryption in CMEK scenarios.", + "description": "The [KMS key](https://cloud.google.com/security-key-management) used for encryption and decryption in CMEK scenarios.", "type": "string" }, "name": { @@ -7564,14 +7564,14 @@ "id": "GoogleCloudDocumentaiV1beta3ProcessorTypeLocationInfo", "properties": { "locationId": { - "description": "The location id, refer to [regional and multi-regional support](/document-ai/docs/regions) for supported locations.", + "description": "The location ID. For supported locations, refer to [regional and multi-regional support](/document-ai/docs/regions).", "type": "string" } }, "type": "object" }, "GoogleCloudDocumentaiV1beta3ProcessorVersion": { - "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pre-trained by Google internally or uptrained by the customer. At a time, a processor can only have one default version version. So the processor's behavior (when processing documents) is defined by a default version", + "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pretrained by Google internally or uptrained by the customer. A processor can only have one default version at a time. Its document-processing behavior is defined by that version.", "id": "GoogleCloudDocumentaiV1beta3ProcessorVersion", "properties": { "createTime": { @@ -8102,7 +8102,7 @@ "type": "object" }, "GoogleTypeColor": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "GoogleTypeColor", "properties": { "alpha": { diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 8824a987387..8030aede833 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -731,7 +731,7 @@ type GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse struct { // GoogleCloudDocumentaiUiv1beta3DocumentId: Document Identifier. type GoogleCloudDocumentaiUiv1beta3DocumentId struct { - // GcsManagedDocId: A document id within user managed Cloud Storage. + // GcsManagedDocId: A document id within user-managed Cloud Storage. GcsManagedDocId *GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId `json:"gcsManagedDocId,omitempty"` // RevisionRef: Points to a specific revision of the document if set. @@ -765,13 +765,13 @@ func (s *GoogleCloudDocumentaiUiv1beta3DocumentId) MarshalJSON() ([]byte, error) } // GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId: -// Identifies a document uniquely within the scope of a dataset in user -// managed Cloud Storage option. +// Identifies a document uniquely within the scope of a dataset in the +// user-managed Cloud Storage option. type GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId struct { // CwDocId: Id of the document (indexed) managed by Content Warehouse. CwDocId string `json:"cwDocId,omitempty"` - // GcsUri: Required. The Cloud Storage uri where the actual document is + // GcsUri: Required. The Cloud Storage URI where the actual document is // stored. GcsUri string `json:"gcsUri,omitempty"` @@ -2932,7 +2932,7 @@ type GoogleCloudDocumentaiV1beta1DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta1DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -3367,7 +3367,7 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -3418,7 +3418,7 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -4282,8 +4282,8 @@ type GoogleCloudDocumentaiV1beta1DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -5203,7 +5203,7 @@ type GoogleCloudDocumentaiV1beta2DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta2DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -5638,7 +5638,7 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -5689,7 +5689,7 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -6553,8 +6553,8 @@ type GoogleCloudDocumentaiV1beta2DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -7218,8 +7218,8 @@ type GoogleCloudDocumentaiV1beta3BatchProcessRequest struct { // ProcessOptions: Inference-time options for the process API ProcessOptions *GoogleCloudDocumentaiV1beta3ProcessOptions `json:"processOptions,omitempty"` - // SkipHumanReview: Whether Human Review feature should be skipped for - // this request. Default to `false`. + // SkipHumanReview: Whether human review should be skipped for this + // request. Default to `false`. SkipHumanReview bool `json:"skipHumanReview,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -7406,13 +7406,13 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b // GoogleCloudDocumentaiV1beta3Dataset: A singleton resource under a // Processor which configures a collection of documents. type GoogleCloudDocumentaiV1beta3Dataset struct { - // DocumentWarehouseConfig: Optional. Document Warehouse-based dataset - // config. + // DocumentWarehouseConfig: Optional. Document AI Warehouse-based + // dataset configuration. DocumentWarehouseConfig *GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig `json:"documentWarehouseConfig,omitempty"` - // GcsManagedConfig: Optional. User managed GCS dataset config. Use this - // config if the dataset documents are stored under a user managed GCS - // location. + // GcsManagedConfig: Optional. User-managed Cloud Storage dataset + // configuration. Use this configuration if the dataset documents are + // stored under a user-managed Cloud Storage location. GcsManagedConfig *GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig `json:"gcsManagedConfig,omitempty"` // Name: Dataset resource name. Format: @@ -7421,12 +7421,11 @@ type GoogleCloudDocumentaiV1beta3Dataset struct { Name string `json:"name,omitempty"` // SpannerIndexingConfig: Optional. A lightweight indexing source with - // low latency and high reliability, but lack advanced features like - // CMEK and content based search. + // low latency and high reliability, but lacking advanced features like + // CMEK and content-based search. SpannerIndexingConfig *GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig `json:"spannerIndexingConfig,omitempty"` - // State: Required. State of the dataset. Will be ignored when updating - // dataset. + // State: Required. State of the dataset. Ignored when updating dataset. // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified enum, should not be used. @@ -7435,9 +7434,9 @@ type GoogleCloudDocumentaiV1beta3Dataset struct { // "INITIALIZED" - Dataset has been initialized. State string `json:"state,omitempty"` - // UnmanagedDatasetConfig: Optional. Unmanaged dataset config. Use this - // config if the dataset documents are managed by the document service - // internally (not user managed). + // UnmanagedDatasetConfig: Optional. Unmanaged dataset configuration. + // Use this configuration if the dataset documents are managed by the + // document service internally (not user-managed). UnmanagedDatasetConfig *GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig `json:"unmanagedDatasetConfig,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -7465,15 +7464,16 @@ func (s *GoogleCloudDocumentaiV1beta3Dataset) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig: Config -// specific to the Document Warehouse-based implementation. +// GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig: +// Configuration specific to the Document AI Warehouse-based +// implementation. type GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig struct { - // Collection: Output only. The collection in Document Warehouse + // Collection: Output only. The collection in Document AI Warehouse // associated with the dataset. Collection string `json:"collection,omitempty"` - // Schema: Output only. The schema in Document Warehouse associated with - // the dataset. + // Schema: Output only. The schema in Document AI Warehouse associated + // with the dataset. Schema string `json:"schema,omitempty"` // ForceSendFields is a list of field names (e.g. "Collection") to @@ -7499,10 +7499,10 @@ func (s *GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig) MarshalJSON return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig: Config specific -// to the GCS-based implementation. +// GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig: Configuration +// specific to the Cloud Storage-based implementation. type GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig struct { - // GcsPrefix: Required. The Cloud Storage uri (a directory) where the + // GcsPrefix: Required. The Cloud Storage URI (a directory) where the // documents belonging to the dataset must be stored. GcsPrefix *GoogleCloudDocumentaiV1beta3GcsPrefix `json:"gcsPrefix,omitempty"` @@ -7567,13 +7567,13 @@ func (s *GoogleCloudDocumentaiV1beta3DatasetSchema) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig: Config -// specific to spanner based indexing. +// GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig: +// Configuration specific to spanner-based indexing. type GoogleCloudDocumentaiV1beta3DatasetSpannerIndexingConfig struct { } -// GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig: Config -// specific to unmanaged config +// GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig: +// Configuration specific to an unmanaged dataset. type GoogleCloudDocumentaiV1beta3DatasetUnmanagedDatasetConfig struct { } @@ -8122,7 +8122,7 @@ type GoogleCloudDocumentaiV1beta3DocumentPage struct { // bounding boxes can be upright and axis-aligned. Image *GoogleCloudDocumentaiV1beta3DocumentPageImage `json:"image,omitempty"` - // ImageQualityScores: Image Quality Scores. + // ImageQualityScores: Image quality scores. ImageQualityScores *GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores `json:"imageQualityScores,omitempty"` // Layout: Layout for the page. @@ -8557,7 +8557,7 @@ func (s *GoogleCloudDocumentaiV1beta3DocumentPageImage) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores: Image -// Quality Scores for the page image. +// quality scores for the page image. type GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores struct { // DetectedDefects: A list of detected defects. DetectedDefects []*GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScoresDetectedDefect `json:"detectedDefects,omitempty"` @@ -8608,7 +8608,7 @@ func (s *GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScores) UnmarshalJS // ct: Image Quality Defects type GoogleCloudDocumentaiV1beta3DocumentPageImageQualityScoresDetectedDefect struct { // Confidence: Confidence of detected defect. Range `[0, 1]` where `1` - // indicates strong confidence of that the defect exists. + // indicates strong confidence that the defect exists. Confidence float64 `json:"confidence,omitempty"` // Type: Name of the defect type. Supported values are: - @@ -9432,10 +9432,10 @@ type GoogleCloudDocumentaiV1beta3DocumentSchemaEntityType struct { // Name: Name of the type. It must be unique within the schema file and // cannot be a "Common Type". The following naming conventions are used: - // - Use `snake_casing` - Name matching is case-sensitive - Maximum 64 + // - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 // characters. - Must start with a letter. - Allowed characters: ASCII // letters `[a-z0-9_-]`. (For backward compatibility internal - // infrastructure and tooling can handle any ascii character) - The `/` + // infrastructure and tooling can handle any ascii character.) - The `/` // is sometimes used to denote a property of a type. For example // `line_item/amount`. This convention is deprecated, but will still be // honored for backward compatibility. @@ -9699,8 +9699,8 @@ type GoogleCloudDocumentaiV1beta3DocumentStyleFontSize struct { // Size: Font size for the text. Size float64 `json:"size,omitempty"` - // Unit: Unit for the font size. Follows CSS naming (`in`, `px`, `pt`, - // etc.). + // Unit: Unit for the font size. Follows CSS naming (such as `in`, `px`, + // and `pt`). Unit string `json:"unit,omitempty"` // ForceSendFields is a list of field names (e.g. "Size") to @@ -9893,7 +9893,7 @@ type GoogleCloudDocumentaiV1beta3EnableProcessorResponse struct { // GoogleCloudDocumentaiV1beta3EntityTypeMetadata: Metadata about an // entity type. type GoogleCloudDocumentaiV1beta3EntityTypeMetadata struct { - // Inactive: Whether the entity type should be considered as "inactive". + // Inactive: Whether the entity type should be considered inactive. Inactive bool `json:"inactive,omitempty"` // ForceSendFields is a list of field names (e.g. "Inactive") to @@ -10977,8 +10977,8 @@ type GoogleCloudDocumentaiV1beta3ProcessRequest struct { // RawDocument: A raw document content (bytes). RawDocument *GoogleCloudDocumentaiV1beta3RawDocument `json:"rawDocument,omitempty"` - // SkipHumanReview: Whether Human Review feature should be skipped for - // this request. Default to false. + // SkipHumanReview: Whether human review should be skipped for this + // request. Default to `false`. SkipHumanReview bool `json:"skipHumanReview,omitempty"` // ForceSendFields is a list of field names (e.g. "Document") to @@ -11063,7 +11063,7 @@ type GoogleCloudDocumentaiV1beta3Processor struct { // KmsKeyName: The KMS key // (https://cloud.google.com/security-key-management) used for - // encryption/decryption in CMEK scenarios. + // encryption and decryption in CMEK scenarios. KmsKeyName string `json:"kmsKeyName,omitempty"` // Name: Output only. Immutable. The resource name of the processor. @@ -11228,8 +11228,8 @@ func (s *GoogleCloudDocumentaiV1beta3ProcessorType) MarshalJSON() ([]byte, error // GoogleCloudDocumentaiV1beta3ProcessorTypeLocationInfo: The location // information about where the processor is available. type GoogleCloudDocumentaiV1beta3ProcessorTypeLocationInfo struct { - // LocationId: The location id, refer to regional and multi-regional - // support (/document-ai/docs/regions) for supported locations. + // LocationId: The location ID. For supported locations, refer to + // regional and multi-regional support (/document-ai/docs/regions). LocationId string `json:"locationId,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to @@ -11257,10 +11257,9 @@ func (s *GoogleCloudDocumentaiV1beta3ProcessorTypeLocationInfo) MarshalJSON() ([ // GoogleCloudDocumentaiV1beta3ProcessorVersion: A processor version is // an implementation of a processor. Each processor can have multiple -// versions, pre-trained by Google internally or uptrained by the -// customer. At a time, a processor can only have one default version -// version. So the processor's behavior (when processing documents) is -// defined by a default version +// versions, pretrained by Google internally or uptrained by the +// customer. A processor can only have one default version at a time. +// Its document-processing behavior is defined by that version. type GoogleCloudDocumentaiV1beta3ProcessorVersion struct { // CreateTime: The time the processor version was created. CreateTime string `json:"createTime,omitempty"` @@ -12167,7 +12166,7 @@ func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, @@ -15470,7 +15469,7 @@ type ProjectsLocationsProcessorsDatasetGetDatasetSchemaCall struct { header_ http.Header } -// GetDatasetSchema: Gets the DatasetSchema of a Dataset. +// GetDatasetSchema: Gets the `DatasetSchema` of a `Dataset`. // // - name: The dataset schema resource name. Format: // projects/{project}/locations/{location}/processors/{processor}/datas @@ -15589,7 +15588,7 @@ func (c *ProjectsLocationsProcessorsDatasetGetDatasetSchemaCall) Do(opts ...goog } return ret, nil // { - // "description": "Gets the DatasetSchema of a Dataset.", + // "description": "Gets the `DatasetSchema` of a `Dataset`.", // "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/dataset/datasetSchema", // "httpMethod": "GET", // "id": "documentai.projects.locations.processors.dataset.getDatasetSchema", @@ -15632,7 +15631,7 @@ type ProjectsLocationsProcessorsDatasetUpdateDatasetSchemaCall struct { header_ http.Header } -// UpdateDatasetSchema: Updates a DatasetSchema. +// UpdateDatasetSchema: Updates a `DatasetSchema`. // // - name: Dataset schema resource name. Format: // `projects/{project}/locations/{location}/processors/{processor}/data @@ -15744,7 +15743,7 @@ func (c *ProjectsLocationsProcessorsDatasetUpdateDatasetSchemaCall) Do(opts ...g } return ret, nil // { - // "description": "Updates a DatasetSchema.", + // "description": "Updates a `DatasetSchema`.", // "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/dataset/datasetSchema", // "httpMethod": "PATCH", // "id": "documentai.projects.locations.processors.dataset.updateDatasetSchema", diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json index f4c7eba8688..3dffde77d55 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20230503", + "revision": "20230611", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -1117,7 +1117,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1142,6 +1142,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index 59182519467..a1185e0aabc 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -1309,7 +1309,7 @@ func (s *DeleteTenantProjectRequest) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1355,6 +1355,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index 33e56e63e75..0d3646b41de 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -500,7 +500,7 @@ } } }, - "revision": "20230503", + "revision": "20230611", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -987,7 +987,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1012,6 +1012,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 754f5db233a..a5bda59d15c 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -1123,7 +1123,7 @@ func (s *CustomHttpPattern) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1169,6 +1169,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json index 857c0f784c8..874a4b6f065 100644 --- a/servicenetworking/v1/servicenetworking-api.json +++ b/servicenetworking/v1/servicenetworking-api.json @@ -865,7 +865,7 @@ } } }, - "revision": "20230507", + "revision": "20230611", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1765,7 +1765,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1790,6 +1790,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index e668b32c653..4bad62e4b8f 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -1913,7 +1913,7 @@ func (s *DnsZone) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1959,6 +1959,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json index 835f69b34f3..0610c7e0bc0 100644 --- a/servicenetworking/v1beta/servicenetworking-api.json +++ b/servicenetworking/v1beta/servicenetworking-api.json @@ -307,7 +307,7 @@ } } }, - "revision": "20230507", + "revision": "20230611", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1064,7 +1064,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1089,6 +1089,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 016661686c1..1bd99e20339 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -1525,7 +1525,7 @@ func (s *DnsZone) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1571,6 +1571,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index ec4c8ecf7b5..8bc239b8bfa 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20230607", + "revision": "20230611", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1138,7 +1138,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1163,6 +1163,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 37602b1e948..ad645508f3f 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -1510,7 +1510,7 @@ func (s *DisableServiceResponse) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1556,6 +1556,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index ed95c577832..43c0ea8e3a3 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20230607", + "revision": "20230611", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1715,7 +1715,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1740,6 +1740,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 16152a2eb58..c318d752487 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -1605,7 +1605,7 @@ func (s *DisableServiceResponse) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1651,6 +1651,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that diff --git a/streetviewpublish/v1/streetviewpublish-api.json b/streetviewpublish/v1/streetviewpublish-api.json index 4d2c0ba4a47..dd7b5810df1 100644 --- a/streetviewpublish/v1/streetviewpublish-api.json +++ b/streetviewpublish/v1/streetviewpublish-api.json @@ -377,7 +377,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Optional. The filter expression. For example: `imagery_type=SPHERICAL`. The filters supported are: `imagery_type`, `processing_state`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, and `filename_query`. See https://google.aip.dev/160 for more information. Filename queries should sent as a Phrase in order to support multiple words and special characters by adding escaped quotes. Ex: filename_query=\"example of a phrase.mp4\"", + "description": "Optional. The filter expression. For example: `imagery_type=SPHERICAL`. The filters supported are: `imagery_type`, `processing_state`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, `filename_query`, `min_capture_time_seconds`, and `max_capture_time_seconds`. See https://google.aip.dev/160 for more information. Filename queries should sent as a Phrase in order to support multiple words and special characters by adding escaped quotes. Ex: filename_query=\"example of a phrase.mp4\"", "location": "query", "type": "string" }, @@ -489,7 +489,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Optional. The filter expression. For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters supported are: `placeId`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, 'min_capture_time_seconds', and 'max_capture_time_seconds'. See https://google.aip.dev/160 for more information.", + "description": "Optional. The filter expression. For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters supported are: `placeId`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`. See https://google.aip.dev/160 for more information.", "location": "query", "type": "string" }, @@ -534,7 +534,7 @@ } } }, - "revision": "20230607", + "revision": "20230611", "rootUrl": "https://streetviewpublish.googleapis.com/", "schemas": { "BatchDeletePhotosRequest": { diff --git a/streetviewpublish/v1/streetviewpublish-gen.go b/streetviewpublish/v1/streetviewpublish-gen.go index bfd49f52e04..38b5afbef51 100644 --- a/streetviewpublish/v1/streetviewpublish-gen.go +++ b/streetviewpublish/v1/streetviewpublish-gen.go @@ -2984,7 +2984,8 @@ func (r *PhotoSequencesService) List() *PhotoSequencesListCall { // Filter sets the optional parameter "filter": The filter expression. // For example: `imagery_type=SPHERICAL`. The filters supported are: // `imagery_type`, `processing_state`, `min_latitude`, `max_latitude`, -// `min_longitude`, `max_longitude`, and `filename_query`. See +// `min_longitude`, `max_longitude`, `filename_query`, +// `min_capture_time_seconds`, and `max_capture_time_seconds`. See // https://google.aip.dev/160 for more information. Filename queries // should sent as a Phrase in order to support multiple words and // special characters by adding escaped quotes. Ex: @@ -3115,7 +3116,7 @@ func (c *PhotoSequencesListCall) Do(opts ...googleapi.CallOption) (*ListPhotoSeq // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Optional. The filter expression. For example: `imagery_type=SPHERICAL`. The filters supported are: `imagery_type`, `processing_state`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, and `filename_query`. See https://google.aip.dev/160 for more information. Filename queries should sent as a Phrase in order to support multiple words and special characters by adding escaped quotes. Ex: filename_query=\"example of a phrase.mp4\"", + // "description": "Optional. The filter expression. For example: `imagery_type=SPHERICAL`. The filters supported are: `imagery_type`, `processing_state`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, `filename_query`, `min_capture_time_seconds`, and `max_capture_time_seconds`. See https://google.aip.dev/160 for more information. Filename queries should sent as a Phrase in order to support multiple words and special characters by adding escaped quotes. Ex: filename_query=\"example of a phrase.mp4\"", // "location": "query", // "type": "string" // }, @@ -3648,9 +3649,8 @@ func (r *PhotosService) List() *PhotosListCall { // Filter sets the optional parameter "filter": The filter expression. // For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters // supported are: `placeId`, `min_latitude`, `max_latitude`, -// `min_longitude`, `max_longitude`, 'min_capture_time_seconds', and -// 'max_capture_time_seconds'. See https://google.aip.dev/160 for more -// information. +// `min_longitude`, `max_longitude`. See https://google.aip.dev/160 for +// more information. func (c *PhotosListCall) Filter(filter string) *PhotosListCall { c.urlParams_.Set("filter", filter) return c @@ -3805,7 +3805,7 @@ func (c *PhotosListCall) Do(opts ...googleapi.CallOption) (*ListPhotosResponse, // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Optional. The filter expression. For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters supported are: `placeId`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`, 'min_capture_time_seconds', and 'max_capture_time_seconds'. See https://google.aip.dev/160 for more information.", + // "description": "Optional. The filter expression. For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`. The filters supported are: `placeId`, `min_latitude`, `max_latitude`, `min_longitude`, `max_longitude`. See https://google.aip.dev/160 for more information.", // "location": "query", // "type": "string" // }, diff --git a/vision/v1/vision-api.json b/vision/v1/vision-api.json index 16547877d10..52e19b5cd36 100644 --- a/vision/v1/vision-api.json +++ b/vision/v1/vision-api.json @@ -1282,7 +1282,7 @@ } } }, - "revision": "20230519", + "revision": "20230608", "rootUrl": "https://vision.googleapis.com/", "schemas": { "AddProductToProductSetRequest": { @@ -1732,7 +1732,7 @@ "type": "object" }, "Color": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "Color", "properties": { "alpha": { diff --git a/vision/v1/vision-gen.go b/vision/v1/vision-gen.go index 68756305200..0d6ad0079a2 100644 --- a/vision/v1/vision-gen.go +++ b/vision/v1/vision-gen.go @@ -1106,7 +1106,7 @@ type CancelOperationRequest struct { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, diff --git a/vision/v1p1beta1/vision-api.json b/vision/v1p1beta1/vision-api.json index 673a58d5279..c124a0bcea2 100644 --- a/vision/v1p1beta1/vision-api.json +++ b/vision/v1p1beta1/vision-api.json @@ -449,7 +449,7 @@ } } }, - "revision": "20230519", + "revision": "20230608", "rootUrl": "https://vision.googleapis.com/", "schemas": { "AnnotateFileResponse": { @@ -714,7 +714,7 @@ "type": "object" }, "Color": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "Color", "properties": { "alpha": { diff --git a/vision/v1p1beta1/vision-gen.go b/vision/v1p1beta1/vision-gen.go index c7f3e3b90cd..3847616b7a9 100644 --- a/vision/v1p1beta1/vision-gen.go +++ b/vision/v1p1beta1/vision-gen.go @@ -647,7 +647,7 @@ func (s *BoundingPoly) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, diff --git a/vision/v1p2beta1/vision-api.json b/vision/v1p2beta1/vision-api.json index cc48c00acb8..a06a7f8918e 100644 --- a/vision/v1p2beta1/vision-api.json +++ b/vision/v1p2beta1/vision-api.json @@ -449,7 +449,7 @@ } } }, - "revision": "20230519", + "revision": "20230608", "rootUrl": "https://vision.googleapis.com/", "schemas": { "AnnotateFileResponse": { @@ -714,7 +714,7 @@ "type": "object" }, "Color": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "Color", "properties": { "alpha": { diff --git a/vision/v1p2beta1/vision-gen.go b/vision/v1p2beta1/vision-gen.go index 4a203fa4c44..7a0e3ca7ab3 100644 --- a/vision/v1p2beta1/vision-gen.go +++ b/vision/v1p2beta1/vision-gen.go @@ -647,7 +647,7 @@ func (s *BoundingPoly) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, From 58512c3c782e9b42d0f215b1f46545686a07033f Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 14 Jun 2023 00:22:13 -0700 Subject: [PATCH 2/4] feat(all): auto-regenerate discovery clients (#2026) --- api-list.json | 4 +- cloudasset/v1/cloudasset-api.json | 171 +-- cloudasset/v1/cloudasset-gen.go | 383 +----- compute/v0.beta/compute-api.json | 8 +- compute/v0.beta/compute-gen.go | 9 +- connectors/v1/connectors-api.json | 89 +- connectors/v1/connectors-gen.go | 99 +- fcm/v1/fcm-api.json | 4 +- fcm/v1/fcm-gen.go | 2 +- firebaseappcheck/v1/firebaseappcheck-api.json | 34 +- firebaseappcheck/v1/firebaseappcheck-gen.go | 98 +- reseller/v1/reseller-api.json | 22 +- reseller/v1/reseller-gen.go | 55 + sqladmin/v1/sqladmin-api.json | 128 +- sqladmin/v1/sqladmin-gen.go | 264 ++++- sqladmin/v1beta4/sqladmin-api.json | 128 +- sqladmin/v1beta4/sqladmin-gen.go | 264 ++++- tagmanager/v2/tagmanager-api.json | 277 ++++- tagmanager/v2/tagmanager-gen.go | 1049 +++++++++++++++++ 19 files changed, 2458 insertions(+), 630 deletions(-) diff --git a/api-list.json b/api-list.json index 08bccde9dde..2f2180db980 100644 --- a/api-list.json +++ b/api-list.json @@ -1161,8 +1161,8 @@ "id": "clouddebugger:v2", "name": "clouddebugger", "version": "v2", - "title": "Cloud Debugger API", - "description": "Examines the call stack and variables of a running application without stopping or slowing it down.", + "title": "Cloud Debugger API (Deprecated)", + "description": "Examines the call stack and variables of a running application without stopping or slowing it down. (Deprecated)", "discoveryRestUrl": "https://clouddebugger.googleapis.com/$discovery/rest?version=v2", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 4b424d301ef..0177952a1c2 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -601,11 +601,6 @@ "location": "query", "type": "boolean" }, - "analysisQuery.options.includeDenyPolicyAnalysis": { - "description": "Optional. If true, the response includes deny policy analysis results, and you can see which access tuples are denied. Default is false.", - "location": "query", - "type": "boolean" - }, "analysisQuery.options.outputGroupEdges": { "description": "Optional. If true, the result will output the relevant membership relationships between groups and other groups, and between groups and principals. Default is false.", "location": "query", @@ -1076,7 +1071,7 @@ "type": "string" }, "readMask": { - "description": "Optional. A comma-separated list of fields specifying which fields to be returned in ResourceSearchResult. Only '*' or combination of top level fields can be specified. Field names of both snake_case and camelCase are supported. Examples: `\"*\"`, `\"name,location\"`, `\"name,versionedResources\"`. The read_mask paths must be valid field paths listed but not limited to (both snake_case and camelCase are supported): * name * assetType * project * displayName * description * location * tagKeys * tagValues * tagValueIds * labels * networkTags * kmsKey (This field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS key information.) * kmsKeys * createTime * updateTime * state * additionalAttributes * versionedResources If read_mask is not specified, all fields except versionedResources will be returned. If only '*' is specified, all fields including versionedResources will be returned. Any invalid field path will trigger INVALID_ARGUMENT error.", + "description": "Optional. A comma-separated list of fields that you want returned in the results. The following fields are returned by default if not specified: * `name` * `assetType` * `project` * `folders` * `organization` * `displayName` * `description` * `location` * `labels` * `networkTags` * `kmsKeys` * `createTime` * `updateTime` * `state` * `additionalAttributes` * `parentFullResourceName` * `parentAssetType` Some fields of large size, such as `versionedResources` and `attachedResources`, are not returned by default, but you can specify them in the `read_mask` parameter if you want to include them. If `\"*\"` is specified, all [available fields](https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult) are returned. Examples: `\"name,location\"`, `\"name,versionedResources\"`, `\"*\"`. Any invalid field path will trigger INVALID_ARGUMENT error.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1100,7 +1095,7 @@ } } }, - "revision": "20230513", + "revision": "20230609", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -1590,24 +1585,6 @@ }, "type": "object" }, - "DeniedAccess": { - "description": "A denied access contains details about an access tuple that is blocked by IAM deny policies.", - "id": "DeniedAccess", - "properties": { - "deniedAccessTuple": { - "$ref": "GoogleCloudAssetV1DeniedAccessAccessTuple", - "description": "A denied access tuple that is either fully or partially denied by IAM deny rules. This access tuple should match at least one access tuple derived from IamPolicyAnalysisResult." - }, - "denyDetails": { - "description": "The details about how denied_access_tuple is denied.", - "items": { - "$ref": "GoogleCloudAssetV1DeniedAccessDenyDetail" - }, - "type": "array" - } - }, - "type": "object" - }, "EffectiveIamPolicy": { "description": "The effective IAM policies on one resource.", "id": "EffectiveIamPolicy", @@ -2087,98 +2064,6 @@ }, "type": "object" }, - "GoogleCloudAssetV1DeniedAccessAccess": { - "description": "An IAM role or permission under analysis.", - "id": "GoogleCloudAssetV1DeniedAccessAccess", - "properties": { - "permission": { - "description": "The IAM permission in [v1 format](https://cloud.google.com/iam/docs/permissions-reference)", - "type": "string" - }, - "role": { - "description": "The IAM role.", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudAssetV1DeniedAccessAccessTuple": { - "description": "An access tuple contains a tuple of a resource, an identity and an access.", - "id": "GoogleCloudAssetV1DeniedAccessAccessTuple", - "properties": { - "access": { - "$ref": "GoogleCloudAssetV1DeniedAccessAccess", - "description": "One access from IamPolicyAnalysisResult.AccessControlList.accesses." - }, - "identity": { - "$ref": "GoogleCloudAssetV1DeniedAccessIdentity", - "description": "One identity from IamPolicyAnalysisResult.IdentityList.identities." - }, - "resource": { - "$ref": "GoogleCloudAssetV1DeniedAccessResource", - "description": "One resource from IamPolicyAnalysisResult.AccessControlList.resources." - } - }, - "type": "object" - }, - "GoogleCloudAssetV1DeniedAccessDenyDetail": { - "description": "A deny detail that explains which IAM deny rule denies the denied_access_tuple.", - "id": "GoogleCloudAssetV1DeniedAccessDenyDetail", - "properties": { - "accesses": { - "description": "The denied accesses. If this deny_rule fully denies the denied_access_tuple, this field will be same as AccessTuple.access. Otherwise, this field can contain AccessTuple.access and its descendant accesses, such as a subset of IAM permissions contained in an IAM role.", - "items": { - "$ref": "GoogleCloudAssetV1DeniedAccessAccess" - }, - "type": "array" - }, - "denyRule": { - "$ref": "GoogleIamV2DenyRule", - "description": "A deny rule in an IAM deny policy." - }, - "fullyDenied": { - "description": "Whether the deny_rule fully denies all access granted by the denied_access_tuple. `True` means the deny rule fully blocks the access tuple. `False` means the deny rule partially blocks the access tuple.\"", - "type": "boolean" - }, - "identities": { - "description": "If this deny_rule fully denies the denied_access_tuple, this field will be same as AccessTuple.identity. Otherwise, this field can contain AccessTuple.identity and its descendant identities, such as a subset of users in a group.", - "items": { - "$ref": "GoogleCloudAssetV1DeniedAccessIdentity" - }, - "type": "array" - }, - "resources": { - "description": "The resources that the identities are denied access to. If this deny_rule fully denies the denied_access_tuple, this field will be same as AccessTuple.resource. Otherwise, this field can contain AccessTuple.resource and its descendant resources.", - "items": { - "$ref": "GoogleCloudAssetV1DeniedAccessResource" - }, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudAssetV1DeniedAccessIdentity": { - "description": "An identity under analysis.", - "id": "GoogleCloudAssetV1DeniedAccessIdentity", - "properties": { - "name": { - "description": "The identity of members, formatted as appear in an [IAM policy binding](https://cloud.google.com/iam/reference/rest/v1/Binding). For example, they might be formatted like the following: - user:foo@google.com - group:group1@google.com - serviceAccount:s1@prj1.iam.gserviceaccount.com - projectOwner:some_project_id - domain:google.com - allUsers", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudAssetV1DeniedAccessResource": { - "description": "A Google Cloud resource under analysis.", - "id": "GoogleCloudAssetV1DeniedAccessResource", - "properties": { - "fullResourceName": { - "description": "The [full resource name](https://cloud.google.com/asset-inventory/docs/resource-name-format)", - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudAssetV1Edge": { "description": "A directional edge.", "id": "GoogleCloudAssetV1Edge", @@ -2317,7 +2202,7 @@ "type": "object" }, "GoogleCloudAssetV1Rule": { - "description": "Represents a rule defined in an organization policy", + "description": "This rule message is a customized version of the one defined in the Organization Policy system. In addition to the fields defined in the original organization policy, it contains additional field(s) under specific circumstances to support analysis results.", "id": "GoogleCloudAssetV1Rule", "properties": { "allowAll": { @@ -2622,45 +2507,6 @@ "properties": {}, "type": "object" }, - "GoogleIamV2DenyRule": { - "description": "A deny rule in an IAM deny policy.", - "id": "GoogleIamV2DenyRule", - "properties": { - "denialCondition": { - "$ref": "Expr", - "description": "The condition that determines whether this deny rule applies to a request. If the condition expression evaluates to `true`, then the deny rule is applied; otherwise, the deny rule is not applied. Each deny rule is evaluated independently. If this deny rule does not apply to a request, other deny rules might still apply. The condition can use CEL functions that evaluate [resource tags](https://cloud.google.com/iam/help/conditions/resource-tags). Other functions and operators are not supported." - }, - "deniedPermissions": { - "description": "The permissions that are explicitly denied by this rule. Each permission uses the format `{service_fqdn}/{resource}.{verb}`, where `{service_fqdn}` is the fully qualified domain name for the service. For example, `iam.googleapis.com/roles.list`.", - "items": { - "type": "string" - }, - "type": "array" - }, - "deniedPrincipals": { - "description": "The identities that are prevented from using one or more permissions on Google Cloud resources. This field can contain the following values: * `principalSet://goog/public:all`: A special identifier that represents any principal that is on the internet, even if they do not have a Google Account or are not logged in. * `principal://goog/subject/{email_id}`: A specific Google Account. Includes Gmail, Cloud Identity, and Google Workspace user accounts. For example, `principal://goog/subject/alice@example.com`. * `deleted:principal://goog/subject/{email_id}?uid={uid}`: A specific Google Account that was deleted recently. For example, `deleted:principal://goog/subject/alice@example.com?uid=1234567890`. If the Google Account is recovered, this identifier reverts to the standard identifier for a Google Account. * `principalSet://goog/group/{group_id}`: A Google group. For example, `principalSet://goog/group/admins@example.com`. * `deleted:principalSet://goog/group/{group_id}?uid={uid}`: A Google group that was deleted recently. For example, `deleted:principalSet://goog/group/admins@example.com?uid=1234567890`. If the Google group is restored, this identifier reverts to the standard identifier for a Google group. * `principal://iam.googleapis.com/projects/-/serviceAccounts/{service_account_id}`: A Google Cloud service account. For example, `principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@iam.gserviceaccount.com`. * `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/{service_account_id}?uid={uid}`: A Google Cloud service account that was deleted recently. For example, `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@iam.gserviceaccount.com?uid=1234567890`. If the service account is undeleted, this identifier reverts to the standard identifier for a service account. * `principalSet://goog/cloudIdentityCustomerId/{customer_id}`: All of the principals associated with the specified Google Workspace or Cloud Identity customer ID. For example, `principalSet://goog/cloudIdentityCustomerId/C01Abc35`.", - "items": { - "type": "string" - }, - "type": "array" - }, - "exceptionPermissions": { - "description": "Specifies the permissions that this rule excludes from the set of denied permissions given by `denied_permissions`. If a permission appears in `denied_permissions` _and_ in `exception_permissions` then it will _not_ be denied. The excluded permissions can be specified using the same syntax as `denied_permissions`.", - "items": { - "type": "string" - }, - "type": "array" - }, - "exceptionPrincipals": { - "description": "The identities that are excluded from the deny rule, even if they are listed in the `denied_principals`. For example, you could add a Google group to the `denied_principals`, then exclude specific users who belong to that group. This field can contain the same values as the `denied_principals` field, excluding `principalSet://goog/public:all`, which represents all users on the internet.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleIdentityAccesscontextmanagerV1AccessLevel": { "description": "An `AccessLevel` is a label that can be applied to requests to Google Cloud services, along with a list of requirements necessary for the label to be applied.", "id": "GoogleIdentityAccesscontextmanagerV1AccessLevel", @@ -3215,13 +3061,6 @@ }, "type": "array" }, - "deniedAccesses": { - "description": "A list of DeniedAccess, which contains all access tuples in the analysis_results that are denied by IAM deny policies. If no access tuples are denied, the list is empty. This is only populated when IamPolicyAnalysisQuery.Options.include_deny_policy_analysis is true.", - "items": { - "$ref": "DeniedAccess" - }, - "type": "array" - }, "fullyExplored": { "description": "Represents whether all entries in the analysis_results have been fully explored to answer the query.", "type": "boolean" @@ -3658,10 +3497,6 @@ "description": "Optional. If true, the access section of result will expand any roles appearing in IAM policy bindings to include their permissions. If IamPolicyAnalysisQuery.access_selector is specified, the access section of the result will be determined by the selector, and this flag is not allowed to set. Default is false.", "type": "boolean" }, - "includeDenyPolicyAnalysis": { - "description": "Optional. If true, the response includes deny policy analysis results, and you can see which access tuples are denied. Default is false.", - "type": "boolean" - }, "outputGroupEdges": { "description": "Optional. If true, the result will output the relevant membership relationships between groups and other groups, and between groups and principals. Default is false.", "type": "boolean" diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 6743162149a..56da9ad6c61 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -1249,41 +1249,6 @@ func (s *Date) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// DeniedAccess: A denied access contains details about an access tuple -// that is blocked by IAM deny policies. -type DeniedAccess struct { - // DeniedAccessTuple: A denied access tuple that is either fully or - // partially denied by IAM deny rules. This access tuple should match at - // least one access tuple derived from IamPolicyAnalysisResult. - DeniedAccessTuple *GoogleCloudAssetV1DeniedAccessAccessTuple `json:"deniedAccessTuple,omitempty"` - - // DenyDetails: The details about how denied_access_tuple is denied. - DenyDetails []*GoogleCloudAssetV1DeniedAccessDenyDetail `json:"denyDetails,omitempty"` - - // ForceSendFields is a list of field names (e.g. "DeniedAccessTuple") - // 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. "DeniedAccessTuple") 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 *DeniedAccess) MarshalJSON() ([]byte, error) { - type NoMethod DeniedAccess - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // EffectiveIamPolicy: The effective IAM policies on one resource. type EffectiveIamPolicy struct { // FullResourceName: The [full_resource_name] @@ -2149,195 +2114,6 @@ func (s *GoogleCloudAssetV1CustomConstraint) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudAssetV1DeniedAccessAccess: An IAM role or permission under -// analysis. -type GoogleCloudAssetV1DeniedAccessAccess struct { - // Permission: The IAM permission in v1 format - // (https://cloud.google.com/iam/docs/permissions-reference) - Permission string `json:"permission,omitempty"` - - // Role: The IAM role. - Role string `json:"role,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Permission") 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. "Permission") 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 *GoogleCloudAssetV1DeniedAccessAccess) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAssetV1DeniedAccessAccess - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleCloudAssetV1DeniedAccessAccessTuple: An access tuple contains a -// tuple of a resource, an identity and an access. -type GoogleCloudAssetV1DeniedAccessAccessTuple struct { - // Access: One access from - // IamPolicyAnalysisResult.AccessControlList.accesses. - Access *GoogleCloudAssetV1DeniedAccessAccess `json:"access,omitempty"` - - // Identity: One identity from - // IamPolicyAnalysisResult.IdentityList.identities. - Identity *GoogleCloudAssetV1DeniedAccessIdentity `json:"identity,omitempty"` - - // Resource: One resource from - // IamPolicyAnalysisResult.AccessControlList.resources. - Resource *GoogleCloudAssetV1DeniedAccessResource `json:"resource,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Access") 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. "Access") 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 *GoogleCloudAssetV1DeniedAccessAccessTuple) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAssetV1DeniedAccessAccessTuple - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleCloudAssetV1DeniedAccessDenyDetail: A deny detail that explains -// which IAM deny rule denies the denied_access_tuple. -type GoogleCloudAssetV1DeniedAccessDenyDetail struct { - // Accesses: The denied accesses. If this deny_rule fully denies the - // denied_access_tuple, this field will be same as AccessTuple.access. - // Otherwise, this field can contain AccessTuple.access and its - // descendant accesses, such as a subset of IAM permissions contained in - // an IAM role. - Accesses []*GoogleCloudAssetV1DeniedAccessAccess `json:"accesses,omitempty"` - - // DenyRule: A deny rule in an IAM deny policy. - DenyRule *GoogleIamV2DenyRule `json:"denyRule,omitempty"` - - // FullyDenied: Whether the deny_rule fully denies all access granted by - // the denied_access_tuple. `True` means the deny rule fully blocks the - // access tuple. `False` means the deny rule partially blocks the access - // tuple." - FullyDenied bool `json:"fullyDenied,omitempty"` - - // Identities: If this deny_rule fully denies the denied_access_tuple, - // this field will be same as AccessTuple.identity. Otherwise, this - // field can contain AccessTuple.identity and its descendant identities, - // such as a subset of users in a group. - Identities []*GoogleCloudAssetV1DeniedAccessIdentity `json:"identities,omitempty"` - - // Resources: The resources that the identities are denied access to. If - // this deny_rule fully denies the denied_access_tuple, this field will - // be same as AccessTuple.resource. Otherwise, this field can contain - // AccessTuple.resource and its descendant resources. - Resources []*GoogleCloudAssetV1DeniedAccessResource `json:"resources,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Accesses") 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. "Accesses") 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 *GoogleCloudAssetV1DeniedAccessDenyDetail) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAssetV1DeniedAccessDenyDetail - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleCloudAssetV1DeniedAccessIdentity: An identity under analysis. -type GoogleCloudAssetV1DeniedAccessIdentity struct { - // Name: The identity of members, formatted as appear in an IAM policy - // binding (https://cloud.google.com/iam/reference/rest/v1/Binding). For - // example, they might be formatted like the following: - - // user:foo@google.com - group:group1@google.com - - // serviceAccount:s1@prj1.iam.gserviceaccount.com - - // projectOwner:some_project_id - domain:google.com - allUsers - Name string `json:"name,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Name") 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. "Name") 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 *GoogleCloudAssetV1DeniedAccessIdentity) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAssetV1DeniedAccessIdentity - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleCloudAssetV1DeniedAccessResource: A Google Cloud resource under -// analysis. -type GoogleCloudAssetV1DeniedAccessResource struct { - // FullResourceName: The full resource name - // (https://cloud.google.com/asset-inventory/docs/resource-name-format) - FullResourceName string `json:"fullResourceName,omitempty"` - - // ForceSendFields is a list of field names (e.g. "FullResourceName") 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. "FullResourceName") 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 *GoogleCloudAssetV1DeniedAccessResource) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAssetV1DeniedAccessResource - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudAssetV1Edge: A directional edge. type GoogleCloudAssetV1Edge struct { // SourceNode: The source node of the edge. For example, it could be a @@ -2653,8 +2429,11 @@ func (s *GoogleCloudAssetV1Resource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudAssetV1Rule: Represents a rule defined in an organization -// policy +// GoogleCloudAssetV1Rule: This rule message is a customized version of +// the one defined in the Organization Policy system. In addition to the +// fields defined in the original organization policy, it contains +// additional field(s) under specific circumstances to support analysis +// results. type GoogleCloudAssetV1Rule struct { // AllowAll: Setting this to true means that all values are allowed. // This field can be set only in Policies for list constraints. @@ -3293,103 +3072,6 @@ func (s *GoogleCloudOrgpolicyV1Policy) MarshalJSON() ([]byte, error) { type GoogleCloudOrgpolicyV1RestoreDefault struct { } -// GoogleIamV2DenyRule: A deny rule in an IAM deny policy. -type GoogleIamV2DenyRule struct { - // DenialCondition: The condition that determines whether this deny rule - // applies to a request. If the condition expression evaluates to - // `true`, then the deny rule is applied; otherwise, the deny rule is - // not applied. Each deny rule is evaluated independently. If this deny - // rule does not apply to a request, other deny rules might still apply. - // The condition can use CEL functions that evaluate resource tags - // (https://cloud.google.com/iam/help/conditions/resource-tags). Other - // functions and operators are not supported. - DenialCondition *Expr `json:"denialCondition,omitempty"` - - // DeniedPermissions: The permissions that are explicitly denied by this - // rule. Each permission uses the format - // `{service_fqdn}/{resource}.{verb}`, where `{service_fqdn}` is the - // fully qualified domain name for the service. For example, - // `iam.googleapis.com/roles.list`. - DeniedPermissions []string `json:"deniedPermissions,omitempty"` - - // DeniedPrincipals: The identities that are prevented from using one or - // more permissions on Google Cloud resources. This field can contain - // the following values: * `principalSet://goog/public:all`: A special - // identifier that represents any principal that is on the internet, - // even if they do not have a Google Account or are not logged in. * - // `principal://goog/subject/{email_id}`: A specific Google Account. - // Includes Gmail, Cloud Identity, and Google Workspace user accounts. - // For example, `principal://goog/subject/alice@example.com`. * - // `deleted:principal://goog/subject/{email_id}?uid={uid}`: A specific - // Google Account that was deleted recently. For example, - // `deleted:principal://goog/subject/alice@example.com?uid=1234567890`. - // If the Google Account is recovered, this identifier reverts to the - // standard identifier for a Google Account. * - // `principalSet://goog/group/{group_id}`: A Google group. For example, - // `principalSet://goog/group/admins@example.com`. * - // `deleted:principalSet://goog/group/{group_id}?uid={uid}`: A Google - // group that was deleted recently. For example, - // `deleted:principalSet://goog/group/admins@example.com?uid=1234567890`. - // If the Google group is restored, this identifier reverts to the - // standard identifier for a Google group. * - // `principal://iam.googleapis.com/projects/-/serviceAccounts/{service_ac - // count_id}`: A Google Cloud service account. For example, - // `principal://iam.googleapis.com/projects/-/serviceAccounts/my-service- - // account@iam.gserviceaccount.com`. * - // `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/{se - // rvice_account_id}?uid={uid}`: A Google Cloud service account that was - // deleted recently. For example, - // `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/my- - // service-account@iam.gserviceaccount.com?uid=1234567890`. If the - // service account is undeleted, this identifier reverts to the standard - // identifier for a service account. * - // `principalSet://goog/cloudIdentityCustomerId/{customer_id}`: All of - // the principals associated with the specified Google Workspace or - // Cloud Identity customer ID. For example, - // `principalSet://goog/cloudIdentityCustomerId/C01Abc35`. - DeniedPrincipals []string `json:"deniedPrincipals,omitempty"` - - // ExceptionPermissions: Specifies the permissions that this rule - // excludes from the set of denied permissions given by - // `denied_permissions`. If a permission appears in `denied_permissions` - // _and_ in `exception_permissions` then it will _not_ be denied. The - // excluded permissions can be specified using the same syntax as - // `denied_permissions`. - ExceptionPermissions []string `json:"exceptionPermissions,omitempty"` - - // ExceptionPrincipals: The identities that are excluded from the deny - // rule, even if they are listed in the `denied_principals`. For - // example, you could add a Google group to the `denied_principals`, - // then exclude specific users who belong to that group. This field can - // contain the same values as the `denied_principals` field, excluding - // `principalSet://goog/public:all`, which represents all users on the - // internet. - ExceptionPrincipals []string `json:"exceptionPrincipals,omitempty"` - - // ForceSendFields is a list of field names (e.g. "DenialCondition") 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. "DenialCondition") 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 *GoogleIamV2DenyRule) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV2DenyRule - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleIdentityAccesscontextmanagerV1AccessLevel: An `AccessLevel` is // a label that can be applied to requests to Google Cloud services, // along with a list of requirements necessary for the label to be @@ -4390,13 +4072,6 @@ type IamPolicyAnalysis struct { // analysis query, or empty if no result is found. AnalysisResults []*IamPolicyAnalysisResult `json:"analysisResults,omitempty"` - // DeniedAccesses: A list of DeniedAccess, which contains all access - // tuples in the analysis_results that are denied by IAM deny policies. - // If no access tuples are denied, the list is empty. This is only - // populated when - // IamPolicyAnalysisQuery.Options.include_deny_policy_analysis is true. - DeniedAccesses []*DeniedAccess `json:"deniedAccesses,omitempty"` - // FullyExplored: Represents whether all entries in the analysis_results // have been fully explored to answer the query. FullyExplored bool `json:"fullyExplored,omitempty"` @@ -5254,11 +4929,6 @@ type Options struct { // and this flag is not allowed to set. Default is false. ExpandRoles bool `json:"expandRoles,omitempty"` - // IncludeDenyPolicyAnalysis: Optional. If true, the response includes - // deny policy analysis results, and you can see which access tuples are - // denied. Default is false. - IncludeDenyPolicyAnalysis bool `json:"includeDenyPolicyAnalysis,omitempty"` - // OutputGroupEdges: Optional. If true, the result will output the // relevant membership relationships between groups and other groups, // and between groups and principals. Default is false. @@ -9517,15 +9187,6 @@ func (c *V1AnalyzeIamPolicyCall) AnalysisQueryOptionsExpandRoles(analysisQueryOp return c } -// AnalysisQueryOptionsIncludeDenyPolicyAnalysis sets the optional -// parameter "analysisQuery.options.includeDenyPolicyAnalysis": If true, -// the response includes deny policy analysis results, and you can see -// which access tuples are denied. Default is false. -func (c *V1AnalyzeIamPolicyCall) AnalysisQueryOptionsIncludeDenyPolicyAnalysis(analysisQueryOptionsIncludeDenyPolicyAnalysis bool) *V1AnalyzeIamPolicyCall { - c.urlParams_.Set("analysisQuery.options.includeDenyPolicyAnalysis", fmt.Sprint(analysisQueryOptionsIncludeDenyPolicyAnalysis)) - return c -} - // AnalysisQueryOptionsOutputGroupEdges sets the optional parameter // "analysisQuery.options.outputGroupEdges": If true, the result will // output the relevant membership relationships between groups and other @@ -9738,11 +9399,6 @@ func (c *V1AnalyzeIamPolicyCall) Do(opts ...googleapi.CallOption) (*AnalyzeIamPo // "location": "query", // "type": "boolean" // }, - // "analysisQuery.options.includeDenyPolicyAnalysis": { - // "description": "Optional. If true, the response includes deny policy analysis results, and you can see which access tuples are denied. Default is false.", - // "location": "query", - // "type": "boolean" - // }, // "analysisQuery.options.outputGroupEdges": { // "description": "Optional. If true, the result will output the relevant membership relationships between groups and other groups, and between groups and principals. Default is false.", // "location": "query", @@ -11873,20 +11529,19 @@ func (c *V1SearchAllResourcesCall) Query(query string) *V1SearchAllResourcesCall } // ReadMask sets the optional parameter "readMask": A comma-separated -// list of fields specifying which fields to be returned in -// ResourceSearchResult. Only '*' or combination of top level fields can -// be specified. Field names of both snake_case and camelCase are -// supported. Examples: "*", "name,location", -// "name,versionedResources". The read_mask paths must be valid field -// paths listed but not limited to (both snake_case and camelCase are -// supported): * name * assetType * project * displayName * description -// * location * tagKeys * tagValues * tagValueIds * labels * networkTags -// * kmsKey (This field is deprecated. Please use the `kmsKeys` field to -// retrieve Cloud KMS key information.) * kmsKeys * createTime * -// updateTime * state * additionalAttributes * versionedResources If -// read_mask is not specified, all fields except versionedResources will -// be returned. If only '*' is specified, all fields including -// versionedResources will be returned. Any invalid field path will +// list of fields that you want returned in the results. The following +// fields are returned by default if not specified: * `name` * +// `assetType` * `project` * `folders` * `organization` * `displayName` +// * `description` * `location` * `labels` * `networkTags` * `kmsKeys` * +// `createTime` * `updateTime` * `state` * `additionalAttributes` * +// `parentFullResourceName` * `parentAssetType` Some fields of large +// size, such as `versionedResources` and `attachedResources`, are not +// returned by default, but you can specify them in the `read_mask` +// parameter if you want to include them. If "*" is specified, all +// available fields +// (https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult) +// are returned. Examples: "name,location", +// "name,versionedResources", "*". Any invalid field path will // trigger INVALID_ARGUMENT error. func (c *V1SearchAllResourcesCall) ReadMask(readMask string) *V1SearchAllResourcesCall { c.urlParams_.Set("readMask", readMask) @@ -12028,7 +11683,7 @@ func (c *V1SearchAllResourcesCall) Do(opts ...googleapi.CallOption) (*SearchAllR // "type": "string" // }, // "readMask": { - // "description": "Optional. A comma-separated list of fields specifying which fields to be returned in ResourceSearchResult. Only '*' or combination of top level fields can be specified. Field names of both snake_case and camelCase are supported. Examples: `\"*\"`, `\"name,location\"`, `\"name,versionedResources\"`. The read_mask paths must be valid field paths listed but not limited to (both snake_case and camelCase are supported): * name * assetType * project * displayName * description * location * tagKeys * tagValues * tagValueIds * labels * networkTags * kmsKey (This field is deprecated. Please use the `kmsKeys` field to retrieve Cloud KMS key information.) * kmsKeys * createTime * updateTime * state * additionalAttributes * versionedResources If read_mask is not specified, all fields except versionedResources will be returned. If only '*' is specified, all fields including versionedResources will be returned. Any invalid field path will trigger INVALID_ARGUMENT error.", + // "description": "Optional. A comma-separated list of fields that you want returned in the results. The following fields are returned by default if not specified: * `name` * `assetType` * `project` * `folders` * `organization` * `displayName` * `description` * `location` * `labels` * `networkTags` * `kmsKeys` * `createTime` * `updateTime` * `state` * `additionalAttributes` * `parentFullResourceName` * `parentAssetType` Some fields of large size, such as `versionedResources` and `attachedResources`, are not returned by default, but you can specify them in the `read_mask` parameter if you want to include them. If `\"*\"` is specified, all [available fields](https://cloud.google.com/asset-inventory/docs/reference/rest/v1/TopLevel/searchAllResources#resourcesearchresult) are returned. Examples: `\"name,location\"`, `\"name,versionedResources\"`, `\"*\"`. Any invalid field path will trigger INVALID_ARGUMENT error.", // "format": "google-fieldmask", // "location": "query", // "type": "string" diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index dba4769ec0a..3d3c99d5358 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -38179,7 +38179,7 @@ } } }, - "revision": "20230530", + "revision": "20230606", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -43001,7 +43001,7 @@ "id": "CustomerEncryptionKey", "properties": { "kmsKeyName": { - "description": "The name of the encryption key that is stored in Google Cloud KMS. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key ", + "description": "The name of the encryption key that is stored in Google Cloud KMS. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 ", "type": "string" }, "kmsKeyServiceAccount": { @@ -65720,6 +65720,10 @@ "description": "The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway", "type": "string" }, + "nextHopHub": { + "description": "[Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets.", + "type": "string" + }, "nextHopIlb": { "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - 10.128.0.56 - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule ", "type": "string" diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index dcd6c3596d2..010228e6d36 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -9071,7 +9071,10 @@ type CustomerEncryptionKey struct { // KmsKeyName: The name of the encryption key that is stored in Google // Cloud KMS. For example: "kmsKeyName": // "projects/kms_project_id/locations/region/keyRings/ - // key_region/cryptoKeys/key + // key_region/cryptoKeys/key The fully-qualifed key name may be returned + // for resource GET requests. For example: "kmsKeyName": + // "projects/kms_project_id/locations/region/keyRings/ + // key_region/cryptoKeys/key /cryptoKeyVersions/1 KmsKeyName string `json:"kmsKeyName,omitempty"` // KmsKeyServiceAccount: The service account being used for the @@ -45182,6 +45185,10 @@ type Route struct { // project/global/gateways/default-internet-gateway NextHopGateway string `json:"nextHopGateway,omitempty"` + // NextHopHub: [Output Only] The full resource name of the Network + // Connectivity Center hub that will handle matching packets. + NextHopHub string `json:"nextHopHub,omitempty"` + // NextHopIlb: The URL to a forwarding rule of type // loadBalancingScheme=INTERNAL that should handle matching packets or // the IP address of the forwarding Rule. For example, the following are diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 9e5e7a4548a..f3bff59df81 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -1449,7 +1449,7 @@ } } }, - "revision": "20230524", + "revision": "20230609", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -1666,6 +1666,10 @@ "description": "Value is a bool.", "type": "boolean" }, + "encryptionKeyValue": { + "$ref": "EncryptionKey", + "description": "Value is a Encryption Key." + }, "intValue": { "description": "Value is an integer", "format": "int64", @@ -1675,10 +1679,6 @@ "description": "Key of the config variable.", "type": "string" }, - "keyValue": { - "$ref": "EncryptionKey", - "description": "Value is a Encryption Key." - }, "secretValue": { "$ref": "Secret", "description": "Value is a secret." @@ -1725,6 +1725,10 @@ "description": "Flag represents that this `ConfigVariable` must be provided for a connection.", "type": "boolean" }, + "requiredCondition": { + "$ref": "LogicalExpression", + "description": "Condition under which a field would be required. The condition can be represented in the form of a logical expression." + }, "roleGrant": { "$ref": "RoleGrant", "description": "Role grant configuration for the config variable." @@ -2598,6 +2602,44 @@ }, "type": "object" }, + "FieldComparison": { + "description": "Field that needs to be compared.", + "id": "FieldComparison", + "properties": { + "boolValue": { + "description": "Boolean value", + "type": "boolean" + }, + "comparator": { + "description": "Comparator to use for comparing the field value.", + "enum": [ + "COMPARATOR_UNSPECIFIED", + "EQUALS", + "NOT_EQUALS" + ], + "enumDescriptions": [ + "The default value.", + "The field value must be equal to the specified value.", + "The field value must not be equal to the specified value." + ], + "type": "string" + }, + "intValue": { + "description": "Integer value", + "format": "int64", + "type": "string" + }, + "key": { + "description": "Key of the field.", + "type": "string" + }, + "stringValue": { + "description": "String value", + "type": "string" + } + }, + "type": "object" + }, "InputParameter": { "description": "Metadata of an input parameter.", "id": "InputParameter", @@ -3002,6 +3044,41 @@ }, "type": "object" }, + "LogicalExpression": { + "description": "Struct for representing boolean expressions.", + "id": "LogicalExpression", + "properties": { + "fieldComparisons": { + "description": "A list of fields to be compared.", + "items": { + "$ref": "FieldComparison" + }, + "type": "array" + }, + "logicalExpressions": { + "description": "A list of nested conditions to be compared.", + "items": { + "$ref": "LogicalExpression" + }, + "type": "array" + }, + "logicalOperator": { + "description": "The logical operator to use between the fields and conditions.", + "enum": [ + "OPERATOR_UNSPECIFIED", + "AND", + "OR" + ], + "enumDescriptions": [ + "The default value.", + "AND operator; The conditions must all be true.", + "OR operator; At least one of the conditions must be true." + ], + "type": "string" + } + }, + "type": "object" + }, "ManagedZone": { "description": "represents the Connector's Managed Zone resource", "id": "ManagedZone", @@ -3473,7 +3550,7 @@ "type": "object" }, "RoleGrant": { - "description": "This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected prinicpal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user.", + "description": "This configuration defines all the Cloud IAM roles that needs to be granted to a particular GCP resource for the selected principal like service account. These configurations will let UI display to customers what IAM roles need to be granted by them. Or these configurations can be used by the UI to render a 'grant' button to do the same on behalf of the user.", "id": "RoleGrant", "properties": { "helperTextTemplate": { diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index b7406117940..d1bfe41189d 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -632,15 +632,15 @@ type ConfigVariable struct { // BoolValue: Value is a bool. BoolValue bool `json:"boolValue,omitempty"` + // EncryptionKeyValue: Value is a Encryption Key. + EncryptionKeyValue *EncryptionKey `json:"encryptionKeyValue,omitempty"` + // IntValue: Value is an integer IntValue int64 `json:"intValue,omitempty,string"` // Key: Key of the config variable. Key string `json:"key,omitempty"` - // KeyValue: Value is a Encryption Key. - KeyValue *EncryptionKey `json:"keyValue,omitempty"` - // SecretValue: Value is a secret. SecretValue *Secret `json:"secretValue,omitempty"` @@ -697,6 +697,10 @@ type ConfigVariableTemplate struct { // for a connection. Required bool `json:"required,omitempty"` + // RequiredCondition: Condition under which a field would be required. + // The condition can be represented in the form of a logical expression. + RequiredCondition *LogicalExpression `json:"requiredCondition,omitempty"` + // RoleGrant: Role grant configuration for the config variable. RoleGrant *RoleGrant `json:"roleGrant,omitempty"` @@ -1715,6 +1719,52 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldComparison: Field that needs to be compared. +type FieldComparison struct { + // BoolValue: Boolean value + BoolValue bool `json:"boolValue,omitempty"` + + // Comparator: Comparator to use for comparing the field value. + // + // Possible values: + // "COMPARATOR_UNSPECIFIED" - The default value. + // "EQUALS" - The field value must be equal to the specified value. + // "NOT_EQUALS" - The field value must not be equal to the specified + // value. + Comparator string `json:"comparator,omitempty"` + + // IntValue: Integer value + IntValue int64 `json:"intValue,omitempty,string"` + + // Key: Key of the field. + Key string `json:"key,omitempty"` + + // StringValue: String value + StringValue string `json:"stringValue,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BoolValue") 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. "BoolValue") 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 *FieldComparison) MarshalJSON() ([]byte, error) { + type NoMethod FieldComparison + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // InputParameter: Metadata of an input parameter. type InputParameter struct { // DataType: The data type of the Parameter. @@ -2302,6 +2352,47 @@ func (s *LockConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// LogicalExpression: Struct for representing boolean expressions. +type LogicalExpression struct { + // FieldComparisons: A list of fields to be compared. + FieldComparisons []*FieldComparison `json:"fieldComparisons,omitempty"` + + // LogicalExpressions: A list of nested conditions to be compared. + LogicalExpressions []*LogicalExpression `json:"logicalExpressions,omitempty"` + + // LogicalOperator: The logical operator to use between the fields and + // conditions. + // + // Possible values: + // "OPERATOR_UNSPECIFIED" - The default value. + // "AND" - AND operator; The conditions must all be true. + // "OR" - OR operator; At least one of the conditions must be true. + LogicalOperator string `json:"logicalOperator,omitempty"` + + // ForceSendFields is a list of field names (e.g. "FieldComparisons") 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. "FieldComparisons") 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 *LogicalExpression) MarshalJSON() ([]byte, error) { + type NoMethod LogicalExpression + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ManagedZone: represents the Connector's Managed Zone resource type ManagedZone struct { // CreateTime: Output only. Created time. @@ -2944,7 +3035,7 @@ func (s *ResultMetadata) MarshalJSON() ([]byte, error) { // RoleGrant: This configuration defines all the Cloud IAM roles that // needs to be granted to a particular GCP resource for the selected -// prinicpal like service account. These configurations will let UI +// principal like service account. These configurations will let UI // display to customers what IAM roles need to be granted by them. Or // these configurations can be used by the UI to render a 'grant' button // to do the same on behalf of the user. diff --git a/fcm/v1/fcm-api.json b/fcm/v1/fcm-api.json index b3b786e07cd..b047b2a39e3 100644 --- a/fcm/v1/fcm-api.json +++ b/fcm/v1/fcm-api.json @@ -146,7 +146,7 @@ } } }, - "revision": "20230522", + "revision": "20230612", "rootUrl": "https://fcm.googleapis.com/", "schemas": { "AndroidConfig": { @@ -420,7 +420,7 @@ "type": "object" }, "Color": { - "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page does not have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", + "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:\u0026red green:\u0026green blue:\u0026blue alpha:\u0026alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "Color", "properties": { "alpha": { diff --git a/fcm/v1/fcm-gen.go b/fcm/v1/fcm-gen.go index 6b11befb0b6..1e36afe79ae 100644 --- a/fcm/v1/fcm-gen.go +++ b/fcm/v1/fcm-gen.go @@ -607,7 +607,7 @@ func (s *ApnsFcmOptions) MarshalJSON() ([]byte, error) { // trivially provided to UIColor's `+colorWithRed:green:blue:alpha` // method in iOS; and, with just a little work, it can be easily // formatted into a CSS `rgba()` string in JavaScript. This reference -// page does not have information about the absolute color space that +// page doesn't have information about the absolute color space that // should be used to interpret the RGB value—for example, sRGB, Adobe // RGB, DCI-P3, and BT.2020. By default, applications should assume the // sRGB color space. When color equality needs to be decided, diff --git a/firebaseappcheck/v1/firebaseappcheck-api.json b/firebaseappcheck/v1/firebaseappcheck-api.json index b4076b81654..d3dba3c4cb1 100644 --- a/firebaseappcheck/v1/firebaseappcheck-api.json +++ b/firebaseappcheck/v1/firebaseappcheck-api.json @@ -1343,7 +1343,7 @@ } } }, - "revision": "20230522", + "revision": "20230612", "rootUrl": "https://firebaseappcheck.googleapis.com/", "schemas": { "GoogleFirebaseAppcheckV1AppAttestConfig": { @@ -1561,6 +1561,10 @@ "description": "Required. A one-time challenge returned by an immediately prior call to GenerateAppAttestChallenge.", "format": "byte", "type": "string" + }, + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" } }, "type": "object" @@ -1583,6 +1587,10 @@ "description": "Required. The key ID generated by App Attest for the client app.", "format": "byte", "type": "string" + }, + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" } }, "type": "object" @@ -1610,6 +1618,10 @@ "customToken": { "description": "Required. A custom token signed using your project's Admin SDK service account credentials.", "type": "string" + }, + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" } }, "type": "object" @@ -1621,6 +1633,10 @@ "debugToken": { "description": "Required. A debug token secret. This string must match a debug token secret previously created using CreateDebugToken.", "type": "string" + }, + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" } }, "type": "object" @@ -1632,6 +1648,10 @@ "deviceToken": { "description": "Required. The `device_token` as returned by Apple's client-side [DeviceCheck API](https://developer.apple.com/documentation/devicecheck/dcdevice). This is the base64 encoded `Data` (Swift) or `NSData` (ObjC) object.", "type": "string" + }, + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" } }, "type": "object" @@ -1640,6 +1660,10 @@ "description": "Request message for the ExchangePlayIntegrityToken method.", "id": "GoogleFirebaseAppcheckV1ExchangePlayIntegrityTokenRequest", "properties": { + "limitedUse": { + "description": "Forces a short-lived token with a 5 minute TTL. Useful when the client wishes to impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" + }, "playIntegrityToken": { "description": "Required. The [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify) issued to your app.", "type": "string" @@ -1651,6 +1675,10 @@ "description": "Request message for the ExchangeRecaptchaEnterpriseToken method.", "id": "GoogleFirebaseAppcheckV1ExchangeRecaptchaEnterpriseTokenRequest", "properties": { + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" + }, "recaptchaEnterpriseToken": { "description": "Required. The reCAPTCHA token as returned by the [reCAPTCHA Enterprise JavaScript API](https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages).", "type": "string" @@ -1662,6 +1690,10 @@ "description": "Request message for the ExchangeRecaptchaV3Token method.", "id": "GoogleFirebaseAppcheckV1ExchangeRecaptchaV3TokenRequest", "properties": { + "limitedUse": { + "description": "Forces a short lived token with a 5 minute TTL. Useful when the client wishes to self impose stricter TTL requirements for this exchange. Default: false.", + "type": "boolean" + }, "recaptchaV3Token": { "description": "Required. The reCAPTCHA token as returned by the [reCAPTCHA v3 JavaScript API](https://developers.google.com/recaptcha/docs/v3).", "type": "string" diff --git a/firebaseappcheck/v1/firebaseappcheck-gen.go b/firebaseappcheck/v1/firebaseappcheck-gen.go index 21aa1344072..bd88f637b42 100644 --- a/firebaseappcheck/v1/firebaseappcheck-gen.go +++ b/firebaseappcheck/v1/firebaseappcheck-gen.go @@ -762,6 +762,11 @@ type GoogleFirebaseAppcheckV1ExchangeAppAttestAssertionRequest struct { // prior call to GenerateAppAttestChallenge. Challenge string `json:"challenge,omitempty"` + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // ForceSendFields is a list of field names (e.g. "Artifact") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -801,6 +806,11 @@ type GoogleFirebaseAppcheckV1ExchangeAppAttestAttestationRequest struct { // app. KeyId string `json:"keyId,omitempty"` + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // ForceSendFields is a list of field names (e.g. // "AttestationStatement") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API @@ -870,6 +880,11 @@ type GoogleFirebaseAppcheckV1ExchangeCustomTokenRequest struct { // Admin SDK service account credentials. CustomToken string `json:"customToken,omitempty"` + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // ForceSendFields is a list of field names (e.g. "CustomToken") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -900,6 +915,11 @@ type GoogleFirebaseAppcheckV1ExchangeDebugTokenRequest struct { // debug token secret previously created using CreateDebugToken. DebugToken string `json:"debugToken,omitempty"` + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // ForceSendFields is a list of field names (e.g. "DebugToken") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -932,6 +952,11 @@ type GoogleFirebaseAppcheckV1ExchangeDeviceCheckTokenRequest struct { // This is the base64 encoded `Data` (Swift) or `NSData` (ObjC) object. DeviceToken string `json:"deviceToken,omitempty"` + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // ForceSendFields is a list of field names (e.g. "DeviceToken") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -958,27 +983,31 @@ func (s *GoogleFirebaseAppcheckV1ExchangeDeviceCheckTokenRequest) MarshalJSON() // GoogleFirebaseAppcheckV1ExchangePlayIntegrityTokenRequest: Request // message for the ExchangePlayIntegrityToken method. type GoogleFirebaseAppcheckV1ExchangePlayIntegrityTokenRequest struct { + // LimitedUse: Forces a short-lived token with a 5 minute TTL. Useful + // when the client wishes to impose stricter TTL requirements for this + // exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // PlayIntegrityToken: Required. The integrity verdict response token // from Play Integrity // (https://developer.android.com/google/play/integrity/verdict#decrypt-verify) // issued to your app. PlayIntegrityToken string `json:"playIntegrityToken,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlayIntegrityToken") - // to unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "LimitedUse") 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. "PlayIntegrityToken") 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 is a list of field names (e.g. "LimitedUse") 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:"-"` } @@ -991,27 +1020,30 @@ func (s *GoogleFirebaseAppcheckV1ExchangePlayIntegrityTokenRequest) MarshalJSON( // GoogleFirebaseAppcheckV1ExchangeRecaptchaEnterpriseTokenRequest: // Request message for the ExchangeRecaptchaEnterpriseToken method. type GoogleFirebaseAppcheckV1ExchangeRecaptchaEnterpriseTokenRequest struct { + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // RecaptchaEnterpriseToken: Required. The reCAPTCHA token as returned // by the reCAPTCHA Enterprise JavaScript API // (https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages). RecaptchaEnterpriseToken string `json:"recaptchaEnterpriseToken,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RecaptchaEnterpriseToken") 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 is a list of field names (e.g. "LimitedUse") 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. "RecaptchaEnterpriseToken") - // 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 is a list of field names (e.g. "LimitedUse") 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:"-"` } @@ -1024,12 +1056,17 @@ func (s *GoogleFirebaseAppcheckV1ExchangeRecaptchaEnterpriseTokenRequest) Marsha // GoogleFirebaseAppcheckV1ExchangeRecaptchaV3TokenRequest: Request // message for the ExchangeRecaptchaV3Token method. type GoogleFirebaseAppcheckV1ExchangeRecaptchaV3TokenRequest struct { + // LimitedUse: Forces a short lived token with a 5 minute TTL. Useful + // when the client wishes to self impose stricter TTL requirements for + // this exchange. Default: false. + LimitedUse bool `json:"limitedUse,omitempty"` + // RecaptchaV3Token: Required. The reCAPTCHA token as returned by the // reCAPTCHA v3 JavaScript API // (https://developers.google.com/recaptcha/docs/v3). RecaptchaV3Token string `json:"recaptchaV3Token,omitempty"` - // ForceSendFields is a list of field names (e.g. "RecaptchaV3Token") to + // ForceSendFields is a list of field names (e.g. "LimitedUse") 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 @@ -1037,13 +1074,12 @@ type GoogleFirebaseAppcheckV1ExchangeRecaptchaV3TokenRequest struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RecaptchaV3Token") 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 is a list of field names (e.g. "LimitedUse") 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:"-"` } diff --git a/reseller/v1/reseller-api.json b/reseller/v1/reseller-api.json index 3000dc9415f..639c68fbeec 100644 --- a/reseller/v1/reseller-api.json +++ b/reseller/v1/reseller-api.json @@ -498,6 +498,21 @@ "customerId" ], "parameters": { + "action": { + "description": "The intented insert action. The usage of this field is governed by certain policies which are being developed \u0026 tested currently. Hence, these might not work as intended. Once this is fully tested \u0026 available to consume, we will share more information about its usage, limitations and policy documentation.", + "enum": [ + "actionUnspecified", + "buy", + "switch" + ], + "enumDescriptions": [ + "Auto determines whether to create new subscription, upgrade or downagrade existing subscription or transfer the existing subscription", + "Create new subscription", + "Switch existing subscription to another sku (upgrade/downgrade)" + ], + "location": "query", + "type": "string" + }, "customerAuthToken": { "description": "The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.", "location": "query", @@ -508,6 +523,11 @@ "location": "path", "required": true, "type": "string" + }, + "sourceSkuId": { + "description": "The sku_id of the existing subscription to be upgraded or downgraded. This is required when action is SWITCH. The usage of this field is governed by certain policies which are being developed \u0026 tested currently. Hence, these might not work as intended. Once this is fully tested \u0026 available to consume, we will share more information about its usage, limitations and policy documentation.", + "location": "query", + "type": "string" } }, "path": "apps/reseller/v1/customers/{customerId}/subscriptions", @@ -631,7 +651,7 @@ } } }, - "revision": "20211106", + "revision": "20230611", "rootUrl": "https://reseller.googleapis.com/", "schemas": { "Address": { diff --git a/reseller/v1/reseller-gen.go b/reseller/v1/reseller-gen.go index c9b9e1e1384..b29d9558e36 100644 --- a/reseller/v1/reseller-gen.go +++ b/reseller/v1/reseller-gen.go @@ -2960,6 +2960,29 @@ func (r *SubscriptionsService) Insert(customerId string, subscription *Subscript return c } +// Action sets the optional parameter "action": The intented insert +// action. The usage of this field is governed by certain policies which +// are being developed & tested currently. Hence, these might not work +// as intended. Once this is fully tested & available to consume, we +// will share more information about its usage, limitations and policy +// documentation. +// +// Possible values: +// +// "actionUnspecified" - Auto determines whether to create new +// +// subscription, upgrade or downagrade existing subscription or transfer +// the existing subscription +// +// "buy" - Create new subscription +// "switch" - Switch existing subscription to another sku +// +// (upgrade/downgrade) +func (c *SubscriptionsInsertCall) Action(action string) *SubscriptionsInsertCall { + c.urlParams_.Set("action", action) + return c +} + // CustomerAuthToken sets the optional parameter "customerAuthToken": // The `customerAuthToken` query string is required when creating a // resold account that transfers a direct customer's subscription or @@ -2972,6 +2995,18 @@ func (c *SubscriptionsInsertCall) CustomerAuthToken(customerAuthToken string) *S return c } +// SourceSkuId sets the optional parameter "sourceSkuId": The sku_id of +// the existing subscription to be upgraded or downgraded. This is +// required when action is SWITCH. The usage of this field is governed +// by certain policies which are being developed & tested currently. +// Hence, these might not work as intended. Once this is fully tested & +// available to consume, we will share more information about its usage, +// limitations and policy documentation. +func (c *SubscriptionsInsertCall) SourceSkuId(sourceSkuId string) *SubscriptionsInsertCall { + c.urlParams_.Set("sourceSkuId", sourceSkuId) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -3071,6 +3106,21 @@ func (c *SubscriptionsInsertCall) Do(opts ...googleapi.CallOption) (*Subscriptio // "customerId" // ], // "parameters": { + // "action": { + // "description": "The intented insert action. The usage of this field is governed by certain policies which are being developed \u0026 tested currently. Hence, these might not work as intended. Once this is fully tested \u0026 available to consume, we will share more information about its usage, limitations and policy documentation.", + // "enum": [ + // "actionUnspecified", + // "buy", + // "switch" + // ], + // "enumDescriptions": [ + // "Auto determines whether to create new subscription, upgrade or downagrade existing subscription or transfer the existing subscription", + // "Create new subscription", + // "Switch existing subscription to another sku (upgrade/downgrade)" + // ], + // "location": "query", + // "type": "string" + // }, // "customerAuthToken": { // "description": "The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.", // "location": "query", @@ -3081,6 +3131,11 @@ func (c *SubscriptionsInsertCall) Do(opts ...googleapi.CallOption) (*Subscriptio // "location": "path", // "required": true, // "type": "string" + // }, + // "sourceSkuId": { + // "description": "The sku_id of the existing subscription to be upgraded or downgraded. This is required when action is SWITCH. The usage of this field is governed by certain policies which are being developed \u0026 tested currently. Hence, these might not work as intended. Once this is fully tested \u0026 available to consume, we will share more information about its usage, limitations and policy documentation.", + // "location": "query", + // "type": "string" // } // }, // "path": "apps/reseller/v1/customers/{customerId}/subscriptions", diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json index b0f60237752..05c2ea68bd8 100644 --- a/sqladmin/v1/sqladmin-api.json +++ b/sqladmin/v1/sqladmin-api.json @@ -1045,6 +1045,41 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "reencrypt": { + "description": "Reencrypt CMEK instance with latest key version.", + "flatPath": "v1/projects/{project}/instances/{instance}/reencrypt", + "httpMethod": "POST", + "id": "sql.instances.reencrypt", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "instance": { + "description": "Cloud SQL instance ID. This does not include the project ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "ID of the project that contains the instance.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "v1/projects/{project}/instances/{instance}/reencrypt", + "request": { + "$ref": "InstancesReencryptRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "resetSslConfig": { "description": "Deletes all client certificates and generates a new server SSL certificate for the instance.", "flatPath": "v1/projects/{project}/instances/{instance}/resetSslConfig", @@ -2055,7 +2090,7 @@ } } }, - "revision": "20230530", + "revision": "20230607", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2183,6 +2218,32 @@ }, "type": "object" }, + "BackupReencryptionConfig": { + "description": "Backup Reencryption Config", + "id": "BackupReencryptionConfig", + "properties": { + "backupLimit": { + "description": "Backup re-encryption limit", + "format": "int32", + "type": "integer" + }, + "backupType": { + "description": "Type of backups users want to re-encrypt.", + "enum": [ + "BACKUP_TYPE_UNSPECIFIED", + "AUTOMATED", + "ON_DEMAND" + ], + "enumDescriptions": [ + "Unknown backup type, will be defaulted to AUTOMATIC backup type", + "Reencrypt automatic backups", + "Reencrypt on-demand backups" + ], + "type": "string" + } + }, + "type": "object" + }, "BackupRetentionSettings": { "description": "We currently only support backup retention by specifying the number of backups we will retain.", "id": "BackupRetentionSettings", @@ -2468,7 +2529,11 @@ "SQLSERVER_2019_STANDARD", "SQLSERVER_2019_ENTERPRISE", "SQLSERVER_2019_EXPRESS", - "SQLSERVER_2019_WEB" + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" ], "enumDescriptions": [ "This is an unknown database version.", @@ -2503,10 +2568,18 @@ "The database version is SQL Server 2019 Standard.", "The database version is SQL Server 2019 Enterprise.", "The database version is SQL Server 2019 Express.", - "The database version is SQL Server 2019 Web." + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." ], "type": "string" }, + "dnsName": { + "description": "The dns name of the instance.", + "type": "string" + }, "ipAddresses": { "description": "The assigned IP addresses for the instance.", "items": { @@ -2669,7 +2742,11 @@ "SQLSERVER_2019_STANDARD", "SQLSERVER_2019_ENTERPRISE", "SQLSERVER_2019_EXPRESS", - "SQLSERVER_2019_WEB" + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" ], "enumDescriptions": [ "This is an unknown database version.", @@ -2704,7 +2781,11 @@ "The database version is SQL Server 2019 Standard.", "The database version is SQL Server 2019 Enterprise.", "The database version is SQL Server 2019 Express.", - "The database version is SQL Server 2019 Web." + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." ], "type": "string" }, @@ -3054,18 +3135,18 @@ "DIFF" ], "enumDescriptions": [ - "default type to meet enum requirement, will be set to FULL if not set", + "default type.", "Full backup.", "Differential backup." ], "type": "string" }, "copyOnly": { - "description": "Whether or not the export will be exeucted with COPY_ONLY, SQL Server only deprecated as the behavior should default to copy_only = true use differential_base instead", + "description": "Deprecated: copy_only is deprecated. Use differential_base instead", "type": "boolean" }, "differentialBase": { - "description": "Whether or not the backup can be use as differential base only non copy only backup can be served as differential base", + "description": "Whether or not the backup can be used as a differential base copy_only backup can not be served as differential base", "type": "boolean" }, "stripeCount": { @@ -3243,7 +3324,11 @@ "SQLSERVER_2019_STANDARD", "SQLSERVER_2019_ENTERPRISE", "SQLSERVER_2019_EXPRESS", - "SQLSERVER_2019_WEB" + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" ], "enumDescriptions": [ "This is an unknown database version.", @@ -3278,7 +3363,11 @@ "The database version is SQL Server 2019 Standard.", "The database version is SQL Server 2019 Enterprise.", "The database version is SQL Server 2019 Express.", - "The database version is SQL Server 2019 Web." + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." ], "type": "string" }, @@ -3406,7 +3495,7 @@ "DIFF" ], "enumDescriptions": [ - "default type to meet enum requirement, will be set to FULL if not set", + "default type.", "Full backup.", "Differential backup." ], @@ -3665,6 +3754,17 @@ }, "type": "object" }, + "InstancesReencryptRequest": { + "description": "Database Instance reencrypt request.", + "id": "InstancesReencryptRequest", + "properties": { + "backupReencryptionConfig": { + "$ref": "BackupReencryptionConfig", + "description": "Configuration specific to backup re-encryption" + } + }, + "type": "object" + }, "InstancesRestoreBackupRequest": { "description": "Database instance restore backup request.", "id": "InstancesRestoreBackupRequest", @@ -4012,7 +4112,8 @@ "START_EXTERNAL_SYNC", "LOG_CLEANUP", "AUTO_RESTART", - "REENCRYPT" + "REENCRYPT", + "SWITCHOVER" ], "enumDescriptions": [ "Unknown operation type.", @@ -4052,7 +4153,8 @@ "Starts external sync of a Cloud SQL EM replica to an external primary instance.", "Recovers logs from an instance's old data disk.", "Performs auto-restart of an HA-enabled Cloud SQL database for auto recovery.", - "Re-encrypts CMEK instances with latest key version." + "Re-encrypts CMEK instances with latest key version.", + "Switches over to replica instance from primary." ], "type": "string" }, diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go index c98982e3c1b..922fa040621 100644 --- a/sqladmin/v1/sqladmin-gen.go +++ b/sqladmin/v1/sqladmin-gen.go @@ -477,6 +477,43 @@ func (s *BackupContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// BackupReencryptionConfig: Backup Reencryption Config +type BackupReencryptionConfig struct { + // BackupLimit: Backup re-encryption limit + BackupLimit int64 `json:"backupLimit,omitempty"` + + // BackupType: Type of backups users want to re-encrypt. + // + // Possible values: + // "BACKUP_TYPE_UNSPECIFIED" - Unknown backup type, will be defaulted + // to AUTOMATIC backup type + // "AUTOMATED" - Reencrypt automatic backups + // "ON_DEMAND" - Reencrypt on-demand backups + BackupType string `json:"backupType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BackupLimit") 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. "BackupLimit") 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 *BackupReencryptionConfig) MarshalJSON() ([]byte, error) { + type NoMethod BackupReencryptionConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BackupRetentionSettings: We currently only support backup retention // by specifying the number of backups we will retain. type BackupRetentionSettings struct { @@ -856,8 +893,18 @@ type ConnectSettings struct { // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 // Express. // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server + // 2022 Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. DatabaseVersion string `json:"databaseVersion,omitempty"` + // DnsName: The dns name of the instance. + DnsName string `json:"dnsName,omitempty"` + // IpAddresses: The assigned IP addresses for the instance. IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` @@ -1093,6 +1140,13 @@ type DatabaseInstance struct { // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 // Express. // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server + // 2022 Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. DatabaseVersion string `json:"databaseVersion,omitempty"` // DiskEncryptionConfiguration: Disk encryption configuration specific @@ -1678,20 +1732,18 @@ type ExportContextBakExportOptions struct { // Server only // // Possible values: - // "BAK_TYPE_UNSPECIFIED" - default type to meet enum requirement, - // will be set to FULL if not set + // "BAK_TYPE_UNSPECIFIED" - default type. // "FULL" - Full backup. // "DIFF" - Differential backup. BakType string `json:"bakType,omitempty"` - // CopyOnly: Whether or not the export will be exeucted with COPY_ONLY, - // SQL Server only deprecated as the behavior should default to - // copy_only = true use differential_base instead + // CopyOnly: Deprecated: copy_only is deprecated. Use differential_base + // instead CopyOnly bool `json:"copyOnly,omitempty"` - // DifferentialBase: Whether or not the backup can be use as - // differential base only non copy only backup can be served as - // differential base + // DifferentialBase: Whether or not the backup can be used as a + // differential base copy_only backup can not be served as differential + // base DifferentialBase bool `json:"differentialBase,omitempty"` // StripeCount: Option for specifying how many stripes to use for the @@ -1951,6 +2003,13 @@ type Flag struct { // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 // Express. // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server + // 2022 Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. AppliesTo []string `json:"appliesTo,omitempty"` // InBeta: Whether or not the flag is considered in beta. @@ -2191,8 +2250,7 @@ type ImportContextBakImportOptions struct { // BakType: Type of the bak content, FULL or DIFF // // Possible values: - // "BAK_TYPE_UNSPECIFIED" - default type to meet enum requirement, - // will be set to FULL if not set + // "BAK_TYPE_UNSPECIFIED" - default type. // "FULL" - Full backup. // "DIFF" - Differential backup. BakType string `json:"bakType,omitempty"` @@ -2632,6 +2690,37 @@ func (s *InstancesListServerCasResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// InstancesReencryptRequest: Database Instance reencrypt request. +type InstancesReencryptRequest struct { + // BackupReencryptionConfig: Configuration specific to backup + // re-encryption + BackupReencryptionConfig *BackupReencryptionConfig `json:"backupReencryptionConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "BackupReencryptionConfig") 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. "BackupReencryptionConfig") + // 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 *InstancesReencryptRequest) MarshalJSON() ([]byte, error) { + type NoMethod InstancesReencryptRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // InstancesRestoreBackupRequest: Database instance restore backup // request. type InstancesRestoreBackupRequest struct { @@ -3182,6 +3271,7 @@ type Operation struct { // "AUTO_RESTART" - Performs auto-restart of an HA-enabled Cloud SQL // database for auto recovery. // "REENCRYPT" - Re-encrypts CMEK instances with latest key version. + // "SWITCHOVER" - Switches over to replica instance from primary. OperationType string `json:"operationType,omitempty"` // SelfLink: The URI of this resource. @@ -9151,6 +9241,160 @@ func (c *InstancesPromoteReplicaCall) Do(opts ...googleapi.CallOption) (*Operati } +// method id "sql.instances.reencrypt": + +type InstancesReencryptCall struct { + s *Service + project string + instance string + instancesreencryptrequest *InstancesReencryptRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Reencrypt: Reencrypt CMEK instance with latest key version. +// +// - instance: Cloud SQL instance ID. This does not include the project +// ID. +// - project: ID of the project that contains the instance. +func (r *InstancesService) Reencrypt(project string, instance string, instancesreencryptrequest *InstancesReencryptRequest) *InstancesReencryptCall { + c := &InstancesReencryptCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.instance = instance + c.instancesreencryptrequest = instancesreencryptrequest + 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 *InstancesReencryptCall) Fields(s ...googleapi.Field) *InstancesReencryptCall { + 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 *InstancesReencryptCall) Context(ctx context.Context) *InstancesReencryptCall { + 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 *InstancesReencryptCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstancesReencryptCall) 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.instancesreencryptrequest) + 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, "v1/projects/{project}/instances/{instance}/reencrypt") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "instance": c.instance, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "sql.instances.reencrypt" 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 *InstancesReencryptCall) 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": "Reencrypt CMEK instance with latest key version.", + // "flatPath": "v1/projects/{project}/instances/{instance}/reencrypt", + // "httpMethod": "POST", + // "id": "sql.instances.reencrypt", + // "parameterOrder": [ + // "project", + // "instance" + // ], + // "parameters": { + // "instance": { + // "description": "Cloud SQL instance ID. This does not include the project ID.", + // "location": "path", + // "required": true, + // "type": "string" + // }, + // "project": { + // "description": "ID of the project that contains the instance.", + // "location": "path", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/projects/{project}/instances/{instance}/reencrypt", + // "request": { + // "$ref": "InstancesReencryptRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/sqlservice.admin" + // ] + // } + +} + // method id "sql.instances.resetSslConfig": type InstancesResetSslConfigCall struct { diff --git a/sqladmin/v1beta4/sqladmin-api.json b/sqladmin/v1beta4/sqladmin-api.json index 59e56682e89..2b0cd6721ca 100644 --- a/sqladmin/v1beta4/sqladmin-api.json +++ b/sqladmin/v1beta4/sqladmin-api.json @@ -1045,6 +1045,41 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "reencrypt": { + "description": "Reencrypt CMEK instance with latest key version.", + "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/reencrypt", + "httpMethod": "POST", + "id": "sql.instances.reencrypt", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "instance": { + "description": "Cloud SQL instance ID. This does not include the project ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "ID of the project that contains the instance.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "sql/v1beta4/projects/{project}/instances/{instance}/reencrypt", + "request": { + "$ref": "InstancesReencryptRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "resetSslConfig": { "description": "Deletes all client certificates and generates a new server SSL certificate for the instance.", "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/resetSslConfig", @@ -2055,7 +2090,7 @@ } } }, - "revision": "20230530", + "revision": "20230607", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2183,6 +2218,32 @@ }, "type": "object" }, + "BackupReencryptionConfig": { + "description": "Backup Reencryption Config", + "id": "BackupReencryptionConfig", + "properties": { + "backupLimit": { + "description": "Backup re-encryption limit", + "format": "int32", + "type": "integer" + }, + "backupType": { + "description": "Type of backups users want to re-encrypt.", + "enum": [ + "BACKUP_TYPE_UNSPECIFIED", + "AUTOMATED", + "ON_DEMAND" + ], + "enumDescriptions": [ + "Unknown backup type, will be defaulted to AUTOMATIC backup type", + "Reencrypt automatic backups", + "Reencrypt on-demand backups" + ], + "type": "string" + } + }, + "type": "object" + }, "BackupRetentionSettings": { "description": "We currently only support backup retention by specifying the number of backups we will retain.", "id": "BackupRetentionSettings", @@ -2468,7 +2529,11 @@ "SQLSERVER_2019_STANDARD", "SQLSERVER_2019_ENTERPRISE", "SQLSERVER_2019_EXPRESS", - "SQLSERVER_2019_WEB" + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" ], "enumDescriptions": [ "This is an unknown database version.", @@ -2503,10 +2568,18 @@ "The database version is SQL Server 2019 Standard.", "The database version is SQL Server 2019 Enterprise.", "The database version is SQL Server 2019 Express.", - "The database version is SQL Server 2019 Web." + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." ], "type": "string" }, + "dnsName": { + "description": "The dns name of the instance.", + "type": "string" + }, "ipAddresses": { "description": "The assigned IP addresses for the instance.", "items": { @@ -2669,7 +2742,11 @@ "SQLSERVER_2019_STANDARD", "SQLSERVER_2019_ENTERPRISE", "SQLSERVER_2019_EXPRESS", - "SQLSERVER_2019_WEB" + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" ], "enumDescriptions": [ "This is an unknown database version.", @@ -2704,7 +2781,11 @@ "The database version is SQL Server 2019 Standard.", "The database version is SQL Server 2019 Enterprise.", "The database version is SQL Server 2019 Express.", - "The database version is SQL Server 2019 Web." + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." ], "type": "string" }, @@ -3054,18 +3135,18 @@ "DIFF" ], "enumDescriptions": [ - "default type to meet enum requirement, will be set to FULL if not set", + "default type.", "Full backup.", "Differential backup." ], "type": "string" }, "copyOnly": { - "description": "Whether or not the export will be exeucted with COPY_ONLY, SQL Server only deprecated as the behavior should default to copy_only = true use differential_base instead", + "description": "Deprecated: copy_only is deprecated. Use differential_base instead", "type": "boolean" }, "differentialBase": { - "description": "Whether or not the backup can be use as differential base only non copy only backup can be served as differential base", + "description": "Whether or not the backup can be used as a differential base copy_only backup can not be served as differential base", "type": "boolean" }, "stripeCount": { @@ -3243,7 +3324,11 @@ "SQLSERVER_2019_STANDARD", "SQLSERVER_2019_ENTERPRISE", "SQLSERVER_2019_EXPRESS", - "SQLSERVER_2019_WEB" + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" ], "enumDescriptions": [ "This is an unknown database version.", @@ -3278,7 +3363,11 @@ "The database version is SQL Server 2019 Standard.", "The database version is SQL Server 2019 Enterprise.", "The database version is SQL Server 2019 Express.", - "The database version is SQL Server 2019 Web." + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." ], "type": "string" }, @@ -3406,7 +3495,7 @@ "DIFF" ], "enumDescriptions": [ - "default type to meet enum requirement, will be set to FULL if not set", + "default type.", "Full backup.", "Differential backup." ], @@ -3665,6 +3754,17 @@ }, "type": "object" }, + "InstancesReencryptRequest": { + "description": "Database Instance reencrypt request.", + "id": "InstancesReencryptRequest", + "properties": { + "backupReencryptionConfig": { + "$ref": "BackupReencryptionConfig", + "description": "Configuration specific to backup re-encryption" + } + }, + "type": "object" + }, "InstancesRestoreBackupRequest": { "description": "Database instance restore backup request.", "id": "InstancesRestoreBackupRequest", @@ -4012,7 +4112,8 @@ "START_EXTERNAL_SYNC", "LOG_CLEANUP", "AUTO_RESTART", - "REENCRYPT" + "REENCRYPT", + "SWITCHOVER" ], "enumDescriptions": [ "Unknown operation type.", @@ -4052,7 +4153,8 @@ "Starts external sync of a Cloud SQL EM replica to an external primary instance.", "Recovers logs from an instance's old data disk.", "Performs auto-restart of an HA-enabled Cloud SQL database for auto recovery.", - "Re-encrypts CMEK instances with latest key version." + "Re-encrypts CMEK instances with latest key version.", + "Switches over to replica instance from primary." ], "type": "string" }, diff --git a/sqladmin/v1beta4/sqladmin-gen.go b/sqladmin/v1beta4/sqladmin-gen.go index 7baff24b723..350e560ec78 100644 --- a/sqladmin/v1beta4/sqladmin-gen.go +++ b/sqladmin/v1beta4/sqladmin-gen.go @@ -477,6 +477,43 @@ func (s *BackupContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// BackupReencryptionConfig: Backup Reencryption Config +type BackupReencryptionConfig struct { + // BackupLimit: Backup re-encryption limit + BackupLimit int64 `json:"backupLimit,omitempty"` + + // BackupType: Type of backups users want to re-encrypt. + // + // Possible values: + // "BACKUP_TYPE_UNSPECIFIED" - Unknown backup type, will be defaulted + // to AUTOMATIC backup type + // "AUTOMATED" - Reencrypt automatic backups + // "ON_DEMAND" - Reencrypt on-demand backups + BackupType string `json:"backupType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BackupLimit") 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. "BackupLimit") 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 *BackupReencryptionConfig) MarshalJSON() ([]byte, error) { + type NoMethod BackupReencryptionConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BackupRetentionSettings: We currently only support backup retention // by specifying the number of backups we will retain. type BackupRetentionSettings struct { @@ -856,8 +893,18 @@ type ConnectSettings struct { // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 // Express. // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server + // 2022 Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. DatabaseVersion string `json:"databaseVersion,omitempty"` + // DnsName: The dns name of the instance. + DnsName string `json:"dnsName,omitempty"` + // IpAddresses: The assigned IP addresses for the instance. IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` @@ -1092,6 +1139,13 @@ type DatabaseInstance struct { // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 // Express. // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server + // 2022 Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. DatabaseVersion string `json:"databaseVersion,omitempty"` // DiskEncryptionConfiguration: Disk encryption configuration specific @@ -1677,20 +1731,18 @@ type ExportContextBakExportOptions struct { // Server only // // Possible values: - // "BAK_TYPE_UNSPECIFIED" - default type to meet enum requirement, - // will be set to FULL if not set + // "BAK_TYPE_UNSPECIFIED" - default type. // "FULL" - Full backup. // "DIFF" - Differential backup. BakType string `json:"bakType,omitempty"` - // CopyOnly: Whether or not the export will be exeucted with COPY_ONLY, - // SQL Server only deprecated as the behavior should default to - // copy_only = true use differential_base instead + // CopyOnly: Deprecated: copy_only is deprecated. Use differential_base + // instead CopyOnly bool `json:"copyOnly,omitempty"` - // DifferentialBase: Whether or not the backup can be use as - // differential base only non copy only backup can be served as - // differential base + // DifferentialBase: Whether or not the backup can be used as a + // differential base copy_only backup can not be served as differential + // base DifferentialBase bool `json:"differentialBase,omitempty"` // StripeCount: Option for specifying how many stripes to use for the @@ -1950,6 +2002,13 @@ type Flag struct { // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 // Express. // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server + // 2022 Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. AppliesTo []string `json:"appliesTo,omitempty"` // InBeta: Whether or not the flag is considered in beta. @@ -2191,8 +2250,7 @@ type ImportContextBakImportOptions struct { // BakType: Type of the bak content, FULL or DIFF. // // Possible values: - // "BAK_TYPE_UNSPECIFIED" - default type to meet enum requirement, - // will be set to FULL if not set + // "BAK_TYPE_UNSPECIFIED" - default type. // "FULL" - Full backup. // "DIFF" - Differential backup. BakType string `json:"bakType,omitempty"` @@ -2632,6 +2690,37 @@ func (s *InstancesListServerCasResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// InstancesReencryptRequest: Database Instance reencrypt request. +type InstancesReencryptRequest struct { + // BackupReencryptionConfig: Configuration specific to backup + // re-encryption + BackupReencryptionConfig *BackupReencryptionConfig `json:"backupReencryptionConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "BackupReencryptionConfig") 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. "BackupReencryptionConfig") + // 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 *InstancesReencryptRequest) MarshalJSON() ([]byte, error) { + type NoMethod InstancesReencryptRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // InstancesRestoreBackupRequest: Database instance restore backup // request. type InstancesRestoreBackupRequest struct { @@ -3182,6 +3271,7 @@ type Operation struct { // "AUTO_RESTART" - Performs auto-restart of an HA-enabled Cloud SQL // database for auto recovery. // "REENCRYPT" - Re-encrypts CMEK instances with latest key version. + // "SWITCHOVER" - Switches over to replica instance from primary. OperationType string `json:"operationType,omitempty"` // SelfLink: The URI of this resource. @@ -9146,6 +9236,160 @@ func (c *InstancesPromoteReplicaCall) Do(opts ...googleapi.CallOption) (*Operati } +// method id "sql.instances.reencrypt": + +type InstancesReencryptCall struct { + s *Service + project string + instance string + instancesreencryptrequest *InstancesReencryptRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Reencrypt: Reencrypt CMEK instance with latest key version. +// +// - instance: Cloud SQL instance ID. This does not include the project +// ID. +// - project: ID of the project that contains the instance. +func (r *InstancesService) Reencrypt(project string, instance string, instancesreencryptrequest *InstancesReencryptRequest) *InstancesReencryptCall { + c := &InstancesReencryptCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.instance = instance + c.instancesreencryptrequest = instancesreencryptrequest + 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 *InstancesReencryptCall) Fields(s ...googleapi.Field) *InstancesReencryptCall { + 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 *InstancesReencryptCall) Context(ctx context.Context) *InstancesReencryptCall { + 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 *InstancesReencryptCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstancesReencryptCall) 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.instancesreencryptrequest) + 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, "sql/v1beta4/projects/{project}/instances/{instance}/reencrypt") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "instance": c.instance, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "sql.instances.reencrypt" 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 *InstancesReencryptCall) 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": "Reencrypt CMEK instance with latest key version.", + // "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/reencrypt", + // "httpMethod": "POST", + // "id": "sql.instances.reencrypt", + // "parameterOrder": [ + // "project", + // "instance" + // ], + // "parameters": { + // "instance": { + // "description": "Cloud SQL instance ID. This does not include the project ID.", + // "location": "path", + // "required": true, + // "type": "string" + // }, + // "project": { + // "description": "ID of the project that contains the instance.", + // "location": "path", + // "required": true, + // "type": "string" + // } + // }, + // "path": "sql/v1beta4/projects/{project}/instances/{instance}/reencrypt", + // "request": { + // "$ref": "InstancesReencryptRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/sqlservice.admin" + // ] + // } + +} + // method id "sql.instances.resetSslConfig": type InstancesResetSslConfigCall struct { diff --git a/tagmanager/v2/tagmanager-api.json b/tagmanager/v2/tagmanager-api.json index e023906c74f..afbe8796b9c 100644 --- a/tagmanager/v2/tagmanager-api.json +++ b/tagmanager/v2/tagmanager-api.json @@ -3050,6 +3050,180 @@ } } }, + "transformations": { + "methods": { + "create": { + "description": "Creates a GTM Transformation.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations", + "httpMethod": "POST", + "id": "tagmanager.accounts.containers.workspaces.transformations.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+parent}/transformations", + "request": { + "$ref": "Transformation" + }, + "response": { + "$ref": "Transformation" + }, + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers" + ] + }, + "delete": { + "description": "Deletes a GTM Transformation.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}", + "httpMethod": "DELETE", + "id": "tagmanager.accounts.containers.workspaces.transformations.delete", + "parameterOrder": [ + "path" + ], + "parameters": { + "path": { + "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+path}", + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers" + ] + }, + "get": { + "description": "Gets a GTM Transformation.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}", + "httpMethod": "GET", + "id": "tagmanager.accounts.containers.workspaces.transformations.get", + "parameterOrder": [ + "path" + ], + "parameters": { + "path": { + "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+path}", + "response": { + "$ref": "Transformation" + }, + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers", + "https://www.googleapis.com/auth/tagmanager.readonly" + ] + }, + "list": { + "description": "Lists all GTM Transformations of a GTM container workspace.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations", + "httpMethod": "GET", + "id": "tagmanager.accounts.containers.workspaces.transformations.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageToken": { + "description": "Continuation token for fetching the next page of results.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+parent}/transformations", + "response": { + "$ref": "ListTransformationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers", + "https://www.googleapis.com/auth/tagmanager.readonly" + ] + }, + "revert": { + "description": "Reverts changes to a GTM Transformation in a GTM Workspace.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}:revert", + "httpMethod": "POST", + "id": "tagmanager.accounts.containers.workspaces.transformations.revert", + "parameterOrder": [ + "path" + ], + "parameters": { + "fingerprint": { + "description": "When provided, this fingerprint must match the fingerprint of the transformation in storage.", + "location": "query", + "type": "string" + }, + "path": { + "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+path}:revert", + "response": { + "$ref": "RevertTransformationResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers" + ] + }, + "update": { + "description": "Updates a GTM Transformation.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}", + "httpMethod": "PUT", + "id": "tagmanager.accounts.containers.workspaces.transformations.update", + "parameterOrder": [ + "path" + ], + "parameters": { + "fingerprint": { + "description": "When provided, this fingerprint must match the fingerprint of the transformation in storage.", + "location": "query", + "type": "string" + }, + "path": { + "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+path}", + "request": { + "$ref": "Transformation" + }, + "response": { + "$ref": "Transformation" + }, + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers" + ] + } + } + }, "triggers": { "methods": { "create": { @@ -3716,7 +3890,7 @@ } } }, - "revision": "20230405", + "revision": "20230612", "rootUrl": "https://tagmanager.googleapis.com/", "schemas": { "Account": { @@ -4351,6 +4525,10 @@ "description": "Whether this Container supports templates.", "type": "boolean" }, + "supportTransformations": { + "description": "Whether this Container supports transformations.", + "type": "boolean" + }, "supportTriggers": { "description": "Whether this Container supports triggers.", "type": "boolean" @@ -4464,6 +4642,13 @@ "description": "Auto generated link to the tag manager UI", "type": "string" }, + "transformation": { + "description": "The transformations in the container that this version was taken from.", + "items": { + "$ref": "Transformation" + }, + "type": "array" + }, "trigger": { "description": "The triggers in the container that this version was taken from.", "items": { @@ -4730,6 +4915,10 @@ "$ref": "Tag", "description": "The tag being represented by the entity." }, + "transformation": { + "$ref": "Transformation", + "description": "The transformation being represented by the entity." + }, "trigger": { "$ref": "Trigger", "description": "The trigger being represented by the entity." @@ -5210,6 +5399,23 @@ }, "type": "object" }, + "ListTransformationsResponse": { + "id": "ListTransformationsResponse", + "properties": { + "nextPageToken": { + "description": "Continuation token for fetching the next page of results.", + "type": "string" + }, + "transformation": { + "description": "All GTM Transformations of a GTM Container.", + "items": { + "$ref": "Transformation" + }, + "type": "array" + } + }, + "type": "object" + }, "ListTriggersResponse": { "description": "List triggers response.", "id": "ListTriggersResponse", @@ -5466,6 +5672,17 @@ }, "type": "object" }, + "RevertTransformationResponse": { + "description": "The result of reverting a transformation in a workspace.", + "id": "RevertTransformationResponse", + "properties": { + "transformation": { + "$ref": "Transformation", + "description": "Transformation as it appears in the latest container version since the last workspace synchronization operation. If no transformation is present, that means the transformation was deleted in the latest container version." + } + }, + "type": "object" + }, "RevertTriggerResponse": { "description": "The result of reverting a trigger in a workspace.", "id": "RevertTriggerResponse", @@ -5748,6 +5965,64 @@ }, "type": "object" }, + "Transformation": { + "description": "Represents a Google Tag Manager Transformation.", + "id": "Transformation", + "properties": { + "accountId": { + "description": "GTM Account ID.", + "type": "string" + }, + "containerId": { + "description": "GTM Container ID.", + "type": "string" + }, + "fingerprint": { + "description": "The fingerprint of the GTM Transformation as computed at storage time. This value is recomputed whenever the transformation is modified.", + "type": "string" + }, + "name": { + "description": "Transformation display name.", + "type": "string" + }, + "notes": { + "description": "User notes on how to apply this transformation in the container.", + "type": "string" + }, + "parameter": { + "description": "The transformation's parameters.", + "items": { + "$ref": "Parameter" + }, + "type": "array" + }, + "parentFolderId": { + "description": "Parent folder id.", + "type": "string" + }, + "path": { + "description": "GTM transformation's API relative path.", + "type": "string" + }, + "tagManagerUrl": { + "description": "Auto generated link to the tag manager UI", + "type": "string" + }, + "transformationId": { + "description": "The Transformation ID uniquely identifies the GTM transformation.", + "type": "string" + }, + "type": { + "description": "Transformation type.", + "type": "string" + }, + "workspaceId": { + "description": "GTM Workspace ID.", + "type": "string" + } + }, + "type": "object" + }, "Trigger": { "description": "Represents a Google Tag Manager Trigger", "id": "Trigger", diff --git a/tagmanager/v2/tagmanager-gen.go b/tagmanager/v2/tagmanager-gen.go index c13b9ecb4db..cb01c0c41a8 100644 --- a/tagmanager/v2/tagmanager-gen.go +++ b/tagmanager/v2/tagmanager-gen.go @@ -250,6 +250,7 @@ func NewAccountsContainersWorkspacesService(s *Service) *AccountsContainersWorks rs.GtagConfig = NewAccountsContainersWorkspacesGtagConfigService(s) rs.Tags = NewAccountsContainersWorkspacesTagsService(s) rs.Templates = NewAccountsContainersWorkspacesTemplatesService(s) + rs.Transformations = NewAccountsContainersWorkspacesTransformationsService(s) rs.Triggers = NewAccountsContainersWorkspacesTriggersService(s) rs.Variables = NewAccountsContainersWorkspacesVariablesService(s) rs.Zones = NewAccountsContainersWorkspacesZonesService(s) @@ -271,6 +272,8 @@ type AccountsContainersWorkspacesService struct { Templates *AccountsContainersWorkspacesTemplatesService + Transformations *AccountsContainersWorkspacesTransformationsService + Triggers *AccountsContainersWorkspacesTriggersService Variables *AccountsContainersWorkspacesVariablesService @@ -332,6 +335,15 @@ type AccountsContainersWorkspacesTemplatesService struct { s *Service } +func NewAccountsContainersWorkspacesTransformationsService(s *Service) *AccountsContainersWorkspacesTransformationsService { + rs := &AccountsContainersWorkspacesTransformationsService{s: s} + return rs +} + +type AccountsContainersWorkspacesTransformationsService struct { + s *Service +} + func NewAccountsContainersWorkspacesTriggersService(s *Service) *AccountsContainersWorkspacesTriggersService { rs := &AccountsContainersWorkspacesTriggersService{s: s} return rs @@ -962,6 +974,10 @@ type ContainerFeatures struct { // SupportTemplates: Whether this Container supports templates. SupportTemplates bool `json:"supportTemplates,omitempty"` + // SupportTransformations: Whether this Container supports + // transformations. + SupportTransformations bool `json:"supportTransformations,omitempty"` + // SupportTriggers: Whether this Container supports triggers. SupportTriggers bool `json:"supportTriggers,omitempty"` @@ -1067,6 +1083,10 @@ type ContainerVersion struct { // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` + // Transformation: The transformations in the container that this + // version was taken from. + Transformation []*Transformation `json:"transformation,omitempty"` + // Trigger: The triggers in the container that this version was taken // from. Trigger []*Trigger `json:"trigger,omitempty"` @@ -1439,6 +1459,9 @@ type Entity struct { // Tag: The tag being represented by the entity. Tag *Tag `json:"tag,omitempty"` + // Transformation: The transformation being represented by the entity. + Transformation *Transformation `json:"transformation,omitempty"` + // Trigger: The trigger being represented by the entity. Trigger *Trigger `json:"trigger,omitempty"` @@ -2248,6 +2271,41 @@ func (s *ListTemplatesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type ListTransformationsResponse struct { + // NextPageToken: Continuation token for fetching the next page of + // results. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Transformation: All GTM Transformations of a GTM Container. + Transformation []*Transformation `json:"transformation,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 *ListTransformationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListTransformationsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListTriggersResponse: List triggers response. type ListTriggersResponse struct { // NextPageToken: Continuation token for fetching the next page of @@ -2805,6 +2863,43 @@ func (s *RevertTemplateResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RevertTransformationResponse: The result of reverting a +// transformation in a workspace. +type RevertTransformationResponse struct { + // Transformation: Transformation as it appears in the latest container + // version since the last workspace synchronization operation. If no + // transformation is present, that means the transformation was deleted + // in the latest container version. + Transformation *Transformation `json:"transformation,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Transformation") 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. "Transformation") 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 *RevertTransformationResponse) MarshalJSON() ([]byte, error) { + type NoMethod RevertTransformationResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // RevertTriggerResponse: The result of reverting a trigger in a // workspace. type RevertTriggerResponse struct { @@ -3258,6 +3353,75 @@ func (s *TeardownTag) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Transformation: Represents a Google Tag Manager Transformation. +type Transformation struct { + // AccountId: GTM Account ID. + AccountId string `json:"accountId,omitempty"` + + // ContainerId: GTM Container ID. + ContainerId string `json:"containerId,omitempty"` + + // Fingerprint: The fingerprint of the GTM Transformation as computed at + // storage time. This value is recomputed whenever the transformation is + // modified. + Fingerprint string `json:"fingerprint,omitempty"` + + // Name: Transformation display name. + Name string `json:"name,omitempty"` + + // Notes: User notes on how to apply this transformation in the + // container. + Notes string `json:"notes,omitempty"` + + // Parameter: The transformation's parameters. + Parameter []*Parameter `json:"parameter,omitempty"` + + // ParentFolderId: Parent folder id. + ParentFolderId string `json:"parentFolderId,omitempty"` + + // Path: GTM transformation's API relative path. + Path string `json:"path,omitempty"` + + // TagManagerUrl: Auto generated link to the tag manager UI + TagManagerUrl string `json:"tagManagerUrl,omitempty"` + + // TransformationId: The Transformation ID uniquely identifies the GTM + // transformation. + TransformationId string `json:"transformationId,omitempty"` + + // Type: Transformation type. + Type string `json:"type,omitempty"` + + // WorkspaceId: GTM Workspace ID. + WorkspaceId string `json:"workspaceId,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "AccountId") 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. "AccountId") 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 *Transformation) MarshalJSON() ([]byte, error) { + type NoMethod Transformation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Trigger: Represents a Google Tag Manager Trigger type Trigger struct { // AccountId: GTM Account ID. @@ -16173,6 +16337,891 @@ func (c *AccountsContainersWorkspacesTemplatesUpdateCall) Do(opts ...googleapi.C } +// method id "tagmanager.accounts.containers.workspaces.transformations.create": + +type AccountsContainersWorkspacesTransformationsCreateCall struct { + s *Service + parent string + transformation *Transformation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a GTM Transformation. +// +// - parent: GTM Workspace's API relative path. Example: +// accounts/{account_id}/containers/{container_id}/workspaces/{workspac +// e_id}. +func (r *AccountsContainersWorkspacesTransformationsService) Create(parent string, transformation *Transformation) *AccountsContainersWorkspacesTransformationsCreateCall { + c := &AccountsContainersWorkspacesTransformationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.transformation = transformation + 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 *AccountsContainersWorkspacesTransformationsCreateCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTransformationsCreateCall { + 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 *AccountsContainersWorkspacesTransformationsCreateCall) Context(ctx context.Context) *AccountsContainersWorkspacesTransformationsCreateCall { + 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 *AccountsContainersWorkspacesTransformationsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTransformationsCreateCall) 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.transformation) + 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, "tagmanager/v2/{+parent}/transformations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", 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 "tagmanager.accounts.containers.workspaces.transformations.create" call. +// Exactly one of *Transformation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Transformation.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 *AccountsContainersWorkspacesTransformationsCreateCall) Do(opts ...googleapi.CallOption) (*Transformation, 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 := &Transformation{ + 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 a GTM Transformation.", + // "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations", + // "httpMethod": "POST", + // "id": "tagmanager.accounts.containers.workspaces.transformations.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + // "location": "path", + // "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "tagmanager/v2/{+parent}/transformations", + // "request": { + // "$ref": "Transformation" + // }, + // "response": { + // "$ref": "Transformation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/tagmanager.edit.containers" + // ] + // } + +} + +// method id "tagmanager.accounts.containers.workspaces.transformations.delete": + +type AccountsContainersWorkspacesTransformationsDeleteCall struct { + s *Service + path string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a GTM Transformation. +// +// - path: GTM Transformation's API relative path. Example: +// accounts/{account_id}/containers/{container_id}/workspaces/{workspac +// e_id}/transformations/{transformation_id}. +func (r *AccountsContainersWorkspacesTransformationsService) Delete(path string) *AccountsContainersWorkspacesTransformationsDeleteCall { + c := &AccountsContainersWorkspacesTransformationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.path = path + 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 *AccountsContainersWorkspacesTransformationsDeleteCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTransformationsDeleteCall { + 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 *AccountsContainersWorkspacesTransformationsDeleteCall) Context(ctx context.Context) *AccountsContainersWorkspacesTransformationsDeleteCall { + 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 *AccountsContainersWorkspacesTransformationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTransformationsDeleteCall) 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 + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "tagmanager/v2/{+path}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "path": c.path, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "tagmanager.accounts.containers.workspaces.transformations.delete" call. +func (c *AccountsContainersWorkspacesTransformationsDeleteCall) Do(opts ...googleapi.CallOption) error { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if err != nil { + return err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return gensupport.WrapError(err) + } + return nil + // { + // "description": "Deletes a GTM Transformation.", + // "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}", + // "httpMethod": "DELETE", + // "id": "tagmanager.accounts.containers.workspaces.transformations.delete", + // "parameterOrder": [ + // "path" + // ], + // "parameters": { + // "path": { + // "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + // "location": "path", + // "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "tagmanager/v2/{+path}", + // "scopes": [ + // "https://www.googleapis.com/auth/tagmanager.edit.containers" + // ] + // } + +} + +// method id "tagmanager.accounts.containers.workspaces.transformations.get": + +type AccountsContainersWorkspacesTransformationsGetCall struct { + s *Service + path string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a GTM Transformation. +// +// - path: GTM Transformation's API relative path. Example: +// accounts/{account_id}/containers/{container_id}/workspaces/{workspac +// e_id}/transformations/{transformation_id}. +func (r *AccountsContainersWorkspacesTransformationsService) Get(path string) *AccountsContainersWorkspacesTransformationsGetCall { + c := &AccountsContainersWorkspacesTransformationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.path = path + 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 *AccountsContainersWorkspacesTransformationsGetCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTransformationsGetCall { + 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 *AccountsContainersWorkspacesTransformationsGetCall) IfNoneMatch(entityTag string) *AccountsContainersWorkspacesTransformationsGetCall { + 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 *AccountsContainersWorkspacesTransformationsGetCall) Context(ctx context.Context) *AccountsContainersWorkspacesTransformationsGetCall { + 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 *AccountsContainersWorkspacesTransformationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTransformationsGetCall) 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, "tagmanager/v2/{+path}") + 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{ + "path": c.path, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "tagmanager.accounts.containers.workspaces.transformations.get" call. +// Exactly one of *Transformation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Transformation.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 *AccountsContainersWorkspacesTransformationsGetCall) Do(opts ...googleapi.CallOption) (*Transformation, 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 := &Transformation{ + 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 a GTM Transformation.", + // "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}", + // "httpMethod": "GET", + // "id": "tagmanager.accounts.containers.workspaces.transformations.get", + // "parameterOrder": [ + // "path" + // ], + // "parameters": { + // "path": { + // "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + // "location": "path", + // "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "tagmanager/v2/{+path}", + // "response": { + // "$ref": "Transformation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/tagmanager.edit.containers", + // "https://www.googleapis.com/auth/tagmanager.readonly" + // ] + // } + +} + +// method id "tagmanager.accounts.containers.workspaces.transformations.list": + +type AccountsContainersWorkspacesTransformationsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all GTM Transformations of a GTM container workspace. +// +// - parent: GTM Workspace's API relative path. Example: +// accounts/{account_id}/containers/{container_id}/workspaces/{workspac +// e_id}. +func (r *AccountsContainersWorkspacesTransformationsService) List(parent string) *AccountsContainersWorkspacesTransformationsListCall { + c := &AccountsContainersWorkspacesTransformationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageToken sets the optional parameter "pageToken": Continuation token +// for fetching the next page of results. +func (c *AccountsContainersWorkspacesTransformationsListCall) PageToken(pageToken string) *AccountsContainersWorkspacesTransformationsListCall { + 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 *AccountsContainersWorkspacesTransformationsListCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTransformationsListCall { + 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 *AccountsContainersWorkspacesTransformationsListCall) IfNoneMatch(entityTag string) *AccountsContainersWorkspacesTransformationsListCall { + 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 *AccountsContainersWorkspacesTransformationsListCall) Context(ctx context.Context) *AccountsContainersWorkspacesTransformationsListCall { + 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 *AccountsContainersWorkspacesTransformationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTransformationsListCall) 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, "tagmanager/v2/{+parent}/transformations") + 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 "tagmanager.accounts.containers.workspaces.transformations.list" call. +// Exactly one of *ListTransformationsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListTransformationsResponse.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 *AccountsContainersWorkspacesTransformationsListCall) Do(opts ...googleapi.CallOption) (*ListTransformationsResponse, 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 := &ListTransformationsResponse{ + 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 GTM Transformations of a GTM container workspace.", + // "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations", + // "httpMethod": "GET", + // "id": "tagmanager.accounts.containers.workspaces.transformations.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageToken": { + // "description": "Continuation token for fetching the next page of results.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + // "location": "path", + // "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "tagmanager/v2/{+parent}/transformations", + // "response": { + // "$ref": "ListTransformationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/tagmanager.edit.containers", + // "https://www.googleapis.com/auth/tagmanager.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 *AccountsContainersWorkspacesTransformationsListCall) Pages(ctx context.Context, f func(*ListTransformationsResponse) 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 "tagmanager.accounts.containers.workspaces.transformations.revert": + +type AccountsContainersWorkspacesTransformationsRevertCall struct { + s *Service + path string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Revert: Reverts changes to a GTM Transformation in a GTM Workspace. +// +// - path: GTM Transformation's API relative path. Example: +// accounts/{account_id}/containers/{container_id}/workspaces/{workspac +// e_id}/transformations/{transformation_id}. +func (r *AccountsContainersWorkspacesTransformationsService) Revert(path string) *AccountsContainersWorkspacesTransformationsRevertCall { + c := &AccountsContainersWorkspacesTransformationsRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.path = path + return c +} + +// Fingerprint sets the optional parameter "fingerprint": When provided, +// this fingerprint must match the fingerprint of the transformation in +// storage. +func (c *AccountsContainersWorkspacesTransformationsRevertCall) Fingerprint(fingerprint string) *AccountsContainersWorkspacesTransformationsRevertCall { + c.urlParams_.Set("fingerprint", fingerprint) + 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 *AccountsContainersWorkspacesTransformationsRevertCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTransformationsRevertCall { + 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 *AccountsContainersWorkspacesTransformationsRevertCall) Context(ctx context.Context) *AccountsContainersWorkspacesTransformationsRevertCall { + 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 *AccountsContainersWorkspacesTransformationsRevertCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTransformationsRevertCall) 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 + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "tagmanager/v2/{+path}:revert") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "path": c.path, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "tagmanager.accounts.containers.workspaces.transformations.revert" call. +// Exactly one of *RevertTransformationResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *RevertTransformationResponse.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 *AccountsContainersWorkspacesTransformationsRevertCall) Do(opts ...googleapi.CallOption) (*RevertTransformationResponse, 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 := &RevertTransformationResponse{ + 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": "Reverts changes to a GTM Transformation in a GTM Workspace.", + // "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}:revert", + // "httpMethod": "POST", + // "id": "tagmanager.accounts.containers.workspaces.transformations.revert", + // "parameterOrder": [ + // "path" + // ], + // "parameters": { + // "fingerprint": { + // "description": "When provided, this fingerprint must match the fingerprint of the transformation in storage.", + // "location": "query", + // "type": "string" + // }, + // "path": { + // "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + // "location": "path", + // "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "tagmanager/v2/{+path}:revert", + // "response": { + // "$ref": "RevertTransformationResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/tagmanager.edit.containers" + // ] + // } + +} + +// method id "tagmanager.accounts.containers.workspaces.transformations.update": + +type AccountsContainersWorkspacesTransformationsUpdateCall struct { + s *Service + path string + transformation *Transformation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Updates a GTM Transformation. +// +// - path: GTM Transformation's API relative path. Example: +// accounts/{account_id}/containers/{container_id}/workspaces/{workspac +// e_id}/transformations/{transformation_id}. +func (r *AccountsContainersWorkspacesTransformationsService) Update(path string, transformation *Transformation) *AccountsContainersWorkspacesTransformationsUpdateCall { + c := &AccountsContainersWorkspacesTransformationsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.path = path + c.transformation = transformation + return c +} + +// Fingerprint sets the optional parameter "fingerprint": When provided, +// this fingerprint must match the fingerprint of the transformation in +// storage. +func (c *AccountsContainersWorkspacesTransformationsUpdateCall) Fingerprint(fingerprint string) *AccountsContainersWorkspacesTransformationsUpdateCall { + c.urlParams_.Set("fingerprint", fingerprint) + 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 *AccountsContainersWorkspacesTransformationsUpdateCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTransformationsUpdateCall { + 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 *AccountsContainersWorkspacesTransformationsUpdateCall) Context(ctx context.Context) *AccountsContainersWorkspacesTransformationsUpdateCall { + 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 *AccountsContainersWorkspacesTransformationsUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTransformationsUpdateCall) 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.transformation) + 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, "tagmanager/v2/{+path}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PUT", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "path": c.path, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "tagmanager.accounts.containers.workspaces.transformations.update" call. +// Exactly one of *Transformation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Transformation.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 *AccountsContainersWorkspacesTransformationsUpdateCall) Do(opts ...googleapi.CallOption) (*Transformation, 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 := &Transformation{ + 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 a GTM Transformation.", + // "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/transformations/{transformationsId}", + // "httpMethod": "PUT", + // "id": "tagmanager.accounts.containers.workspaces.transformations.update", + // "parameterOrder": [ + // "path" + // ], + // "parameters": { + // "fingerprint": { + // "description": "When provided, this fingerprint must match the fingerprint of the transformation in storage.", + // "location": "query", + // "type": "string" + // }, + // "path": { + // "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + // "location": "path", + // "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "tagmanager/v2/{+path}", + // "request": { + // "$ref": "Transformation" + // }, + // "response": { + // "$ref": "Transformation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/tagmanager.edit.containers" + // ] + // } + +} + // method id "tagmanager.accounts.containers.workspaces.triggers.create": type AccountsContainersWorkspacesTriggersCreateCall struct { From 229def0dc32b86ab6524a4619189aece0b1ebbea Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 15 Jun 2023 00:22:37 -0700 Subject: [PATCH 3/4] feat(all): auto-regenerate discovery clients (#2027) --- admin/reports/v1/admin-api.json | 8 +- admin/reports/v1/admin-gen.go | 18 +- api-list.json | 15 - assuredworkloads/v1/assuredworkloads-api.json | 8 +- assuredworkloads/v1/assuredworkloads-gen.go | 10 +- .../v1beta1/assuredworkloads-api.json | 8 +- .../v1beta1/assuredworkloads-gen.go | 10 +- .../v1/bigqueryreservation-api.json | 4 +- .../v1/bigqueryreservation-gen.go | 10 +- cloudchannel/v1/cloudchannel-api.json | 8 +- cloudchannel/v1/cloudchannel-gen.go | 10 +- clouddebugger/v2/clouddebugger-api.json | 6 +- clouddebugger/v2/clouddebugger-gen.go | 2 +- drive/v3/drive-api.json | 24 +- drive/v3/drive-gen.go | 42 +- gmail/v1/gmail-api.json | 14 +- gmail/v1/gmail-gen.go | 11 + recommender/v1beta1/recommender-api.json | 122 +++- recommender/v1beta1/recommender-gen.go | 525 ++++++++++++++++++ retail/v2/retail-api.json | 137 ++++- retail/v2/retail-gen.go | 359 ++++++++++++ retail/v2alpha/retail-api.json | 94 +++- retail/v2alpha/retail-gen.go | 156 ++++++ retail/v2beta/retail-api.json | 137 ++++- retail/v2beta/retail-gen.go | 359 ++++++++++++ .../v1/servicemanagement-api.json | 11 +- servicemanagement/v1/servicemanagement-gen.go | 7 +- 27 files changed, 2016 insertions(+), 99 deletions(-) diff --git a/admin/reports/v1/admin-api.json b/admin/reports/v1/admin-api.json index 5d11c3bc9d6..3023a1ab765 100644 --- a/admin/reports/v1/admin-api.json +++ b/admin/reports/v1/admin-api.json @@ -431,7 +431,7 @@ "type": "string" }, "date": { - "description": "Represents the date the usage occurred, based on PST time zone. The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", + "description": "Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", "location": "path", "pattern": "(\\d){4}-(\\d){2}-(\\d){2}", "required": true, @@ -479,7 +479,7 @@ "type": "string" }, "date": { - "description": "Represents the date the usage occurred. The timestamp is in the ISO 8601 format, yyyy-mm-dd. We recommend you use your account's time zone for this.", + "description": "Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", "location": "path", "pattern": "(\\d){4}-(\\d){2}-(\\d){2}", "required": true, @@ -560,7 +560,7 @@ "type": "string" }, "date": { - "description": "Represents the date the usage occurred, based on GMT-7:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", + "description": "Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", "location": "path", "pattern": "(\\d){4}-(\\d){2}-(\\d){2}", "required": true, @@ -623,7 +623,7 @@ } } }, - "revision": "20230406", + "revision": "20230612", "rootUrl": "https://admin.googleapis.com/", "schemas": { "Activities": { diff --git a/admin/reports/v1/admin-gen.go b/admin/reports/v1/admin-gen.go index 58337a1d582..0ad19757feb 100644 --- a/admin/reports/v1/admin-gen.go +++ b/admin/reports/v1/admin-gen.go @@ -1877,8 +1877,8 @@ type CustomerUsageReportsGetCall struct { // customer report's parameters, see the Customers Usage parameters // reference guides. // -// - date: Represents the date the usage occurred, based on PST time -// zone. The timestamp is in the ISO 8601 format +// - date: Represents the date the usage occurred, based on UTC-8:00 +// (Pacific Standard Time). The timestamp is in the ISO 8601 format // (https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`. func (r *CustomerUsageReportsService) Get(date string) *CustomerUsageReportsGetCall { c := &CustomerUsageReportsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -2038,7 +2038,7 @@ func (c *CustomerUsageReportsGetCall) Do(opts ...googleapi.CallOption) (*UsageRe // "type": "string" // }, // "date": { - // "description": "Represents the date the usage occurred, based on PST time zone. The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", + // "description": "Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", // "location": "path", // "pattern": "(\\d){4}-(\\d){2}-(\\d){2}", // "required": true, @@ -2107,9 +2107,9 @@ type EntityUsageReportsGetCall struct { // information about the entities report's parameters, see the Entities // Usage parameters reference guides. // -// - date: Represents the date the usage occurred. The timestamp is in -// the ISO 8601 format, yyyy-mm-dd. We recommend you use your -// account's time zone for this. +// - date: Represents the date the usage occurred, based on UTC-8:00 +// (Pacific Standard Time). The timestamp is in the ISO 8601 format +// (https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`. // - entityKey: Represents the key of the object to filter the data // with. It is a string which can take the value `all` to get activity // events for all users, or any other value for an app-specific @@ -2313,7 +2313,7 @@ func (c *EntityUsageReportsGetCall) Do(opts ...googleapi.CallOption) (*UsageRepo // "type": "string" // }, // "date": { - // "description": "Represents the date the usage occurred. The timestamp is in the ISO 8601 format, yyyy-mm-dd. We recommend you use your account's time zone for this.", + // "description": "Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", // "location": "path", // "pattern": "(\\d){4}-(\\d){2}-(\\d){2}", // "required": true, @@ -2414,7 +2414,7 @@ type UserUsageReportGetCall struct { // see the User Usage Report guide. For more information about the user // report's parameters, see the Users Usage parameters reference guides. // -// - date: Represents the date the usage occurred, based on GMT-7:00 +// - date: Represents the date the usage occurred, based on UTC-8:00 // (Pacific Standard Time). The timestamp is in the ISO 8601 format // (https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`. // - userKey: Represents the profile ID or the user email for which the @@ -2636,7 +2636,7 @@ func (c *UserUsageReportGetCall) Do(opts ...googleapi.CallOption) (*UsageReports // "type": "string" // }, // "date": { - // "description": "Represents the date the usage occurred, based on GMT-7:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", + // "description": "Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`.", // "location": "path", // "pattern": "(\\d){4}-(\\d){2}-(\\d){2}", // "required": true, diff --git a/api-list.json b/api-list.json index 2f2180db980..f359beebd0e 100644 --- a/api-list.json +++ b/api-list.json @@ -2479,21 +2479,6 @@ "documentationLink": "https://developers.google.com/domains/rdap/", "preferred": true }, - { - "kind": "discovery#directoryItem", - "id": "doubleclickbidmanager:v1.1", - "name": "doubleclickbidmanager", - "version": "v1.1", - "title": "DoubleClick Bid Manager API", - "description": "DoubleClick Bid Manager API allows users to manage and create campaigns and reports.", - "discoveryRestUrl": "https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v1.1", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://developers.google.com/bid-manager/", - "preferred": false - }, { "kind": "discovery#directoryItem", "id": "doubleclickbidmanager:v2", diff --git a/assuredworkloads/v1/assuredworkloads-api.json b/assuredworkloads/v1/assuredworkloads-api.json index 54329e5cc0c..2f674725b93 100644 --- a/assuredworkloads/v1/assuredworkloads-api.json +++ b/assuredworkloads/v1/assuredworkloads-api.json @@ -519,11 +519,11 @@ } } }, - "revision": "20230512", + "revision": "20230612", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest": { - "description": "Request for acknowledging the violation Next Id: 4", + "description": "Request for acknowledging the violation Next Id: 5", "id": "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest", "properties": { "comment": { @@ -1058,12 +1058,12 @@ "id": "GoogleCloudAssuredworkloadsV1WorkloadComplianceStatus", "properties": { "acknowledgedViolationCount": { - "description": "Count of active Violations which are acknowledged in the Workload.", + "description": "Number of current orgPolicy violations which are acknowledged.", "format": "int32", "type": "integer" }, "activeViolationCount": { - "description": "Count of active Violations which haven't been acknowledged.", + "description": "Number of current orgPolicy violations which are not acknowledged.", "format": "int32", "type": "integer" } diff --git a/assuredworkloads/v1/assuredworkloads-gen.go b/assuredworkloads/v1/assuredworkloads-gen.go index 12d8dc4ad1f..d1079b27f38 100644 --- a/assuredworkloads/v1/assuredworkloads-gen.go +++ b/assuredworkloads/v1/assuredworkloads-gen.go @@ -196,7 +196,7 @@ type OrganizationsLocationsWorkloadsViolationsService struct { } // GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest: Request for -// acknowledging the violation Next Id: 4 +// acknowledging the violation Next Id: 5 type GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest struct { // Comment: Required. Business justification explaining the need for // violation acknowledgement @@ -914,12 +914,12 @@ func (s *GoogleCloudAssuredworkloadsV1Workload) MarshalJSON() ([]byte, error) { // GoogleCloudAssuredworkloadsV1WorkloadComplianceStatus: Represents the // Compliance Status of this workload type GoogleCloudAssuredworkloadsV1WorkloadComplianceStatus struct { - // AcknowledgedViolationCount: Count of active Violations which are - // acknowledged in the Workload. + // AcknowledgedViolationCount: Number of current orgPolicy violations + // which are acknowledged. AcknowledgedViolationCount int64 `json:"acknowledgedViolationCount,omitempty"` - // ActiveViolationCount: Count of active Violations which haven't been - // acknowledged. + // ActiveViolationCount: Number of current orgPolicy violations which + // are not acknowledged. ActiveViolationCount int64 `json:"activeViolationCount,omitempty"` // ForceSendFields is a list of field names (e.g. diff --git a/assuredworkloads/v1beta1/assuredworkloads-api.json b/assuredworkloads/v1beta1/assuredworkloads-api.json index f258c5ff9d4..ba1fc28d470 100644 --- a/assuredworkloads/v1beta1/assuredworkloads-api.json +++ b/assuredworkloads/v1beta1/assuredworkloads-api.json @@ -595,11 +595,11 @@ } } }, - "revision": "20230512", + "revision": "20230612", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest": { - "description": "Request for acknowledging the violation Next Id: 4", + "description": "Request for acknowledging the violation Next Id: 5", "id": "GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest", "properties": { "comment": { @@ -1200,12 +1200,12 @@ "id": "GoogleCloudAssuredworkloadsV1beta1WorkloadComplianceStatus", "properties": { "acknowledgedViolationCount": { - "description": "Count of active Violations which are acknowledged in the Workload.", + "description": "Number of current orgPolicy violations which are acknowledged.", "format": "int32", "type": "integer" }, "activeViolationCount": { - "description": "Count of active Violations which haven't been acknowledged.", + "description": "Number of current orgPolicy violations which are not acknowledged.", "format": "int32", "type": "integer" } diff --git a/assuredworkloads/v1beta1/assuredworkloads-gen.go b/assuredworkloads/v1beta1/assuredworkloads-gen.go index cf4f449edcd..695f0a6e1aa 100644 --- a/assuredworkloads/v1beta1/assuredworkloads-gen.go +++ b/assuredworkloads/v1beta1/assuredworkloads-gen.go @@ -280,7 +280,7 @@ type ProjectsOrganizationsLocationsWorkloadsService struct { } // GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest: -// Request for acknowledging the violation Next Id: 4 +// Request for acknowledging the violation Next Id: 5 type GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest struct { // Comment: Required. Business justification explaining the need for // violation acknowledgement @@ -1115,12 +1115,12 @@ func (s *GoogleCloudAssuredworkloadsV1beta1WorkloadComplianceControlsOrgPolicyCo // GoogleCloudAssuredworkloadsV1beta1WorkloadComplianceStatus: // Represents the Compliance Status of this workload type GoogleCloudAssuredworkloadsV1beta1WorkloadComplianceStatus struct { - // AcknowledgedViolationCount: Count of active Violations which are - // acknowledged in the Workload. + // AcknowledgedViolationCount: Number of current orgPolicy violations + // which are acknowledged. AcknowledgedViolationCount int64 `json:"acknowledgedViolationCount,omitempty"` - // ActiveViolationCount: Count of active Violations which haven't been - // acknowledged. + // ActiveViolationCount: Number of current orgPolicy violations which + // are not acknowledged. ActiveViolationCount int64 `json:"activeViolationCount,omitempty"` // ForceSendFields is a list of field names (e.g. diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index 6b55598db4e..2029dc75015 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -824,7 +824,7 @@ } } }, - "revision": "20230521", + "revision": "20230610", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -1192,7 +1192,7 @@ "type": "string" }, "slotCapacity": { - "description": "Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If edition is EDITION_UNSPECIFIED and total slot_capacity of the reservation and its siblings exceeds the total slot_count of all capacity commitments, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`. If edition is any value but EDITION_UNSPECIFIED, then the above requirement is not needed. The total slot_capacity of the reservation and its siblings may exceed the total slot_count of capacity commitments. In that case, the exceeding slots will be charged with the autoscale SKU. You can increase the number of baseline slots in a reservation every few minutes. If you want to decrease your baseline slots, you are limited to once an hour if you have recently changed your baseline slot capacity and your baseline slots exceed your committed slots. Otherwise, you can decrease your baseline slots every few minutes. NOTE: for reservations in US or EU multi-regions, slot capacity constraints are checked separately for default and auxiliary regions. See multi_region_auxiliary flag for more details.", + "description": "Baseline slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false, or autoscaling is enabled. If edition is EDITION_UNSPECIFIED and total slot_capacity of the reservation and its siblings exceeds the total slot_count of all capacity commitments, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`. If edition is any value but EDITION_UNSPECIFIED, then the above requirement is not needed. The total slot_capacity of the reservation and its siblings may exceed the total slot_count of capacity commitments. In that case, the exceeding slots will be charged with the autoscale SKU. You can increase the number of baseline slots in a reservation every few minutes. If you want to decrease your baseline slots, you are limited to once an hour if you have recently changed your baseline slot capacity and your baseline slots exceed your committed slots. Otherwise, you can decrease your baseline slots every few minutes. NOTE: for reservations in US or EU multi-regions, slot capacity constraints are checked separately for default and auxiliary regions. See multi_region_auxiliary flag for more details.", "format": "int64", "type": "string" }, diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 1ad3dc9511a..fe5b384803d 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -767,13 +767,13 @@ type Reservation struct { // length is 64 characters. Name string `json:"name,omitempty"` - // SlotCapacity: Minimum slots available to this reservation. A slot is + // SlotCapacity: Baseline slots available to this reservation. A slot is // a unit of computational power in BigQuery, and serves as the unit of // parallelism. Queries using this reservation might use more slots - // during runtime if ignore_idle_slots is set to false. If edition is - // EDITION_UNSPECIFIED and total slot_capacity of the reservation and - // its siblings exceeds the total slot_count of all capacity - // commitments, the request will fail with + // during runtime if ignore_idle_slots is set to false, or autoscaling + // is enabled. If edition is EDITION_UNSPECIFIED and total slot_capacity + // of the reservation and its siblings exceeds the total slot_count of + // all capacity commitments, the request will fail with // `google.rpc.Code.RESOURCE_EXHAUSTED`. If edition is any value but // EDITION_UNSPECIFIED, then the above requirement is not needed. The // total slot_capacity of the reservation and its siblings may exceed diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index 2459a69f244..8cfab748937 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -936,7 +936,7 @@ ], "parameters": { "changeOfferPurchase.billingAccount": { - "description": "Optional. Resource name of the new target Billing Account. Provide this Billing Account when setting up billing for a trial subscription. Format: accounts/{account_id}/billing_accounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.", + "description": "Optional. Resource name of the new target Billing Account. Provide this Billing Account when setting up billing for a trial subscription. Format: accounts/{account_id}/billingAccounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.", "location": "query", "type": "string" }, @@ -951,7 +951,7 @@ "type": "string" }, "createEntitlementPurchase.billingAccount": { - "description": "Optional. Billing account that the result should be restricted to. Format: accounts/{account_id}/billing_accounts/{billing_account_id}.", + "description": "Optional. Billing account that the result should be restricted to. Format: accounts/{account_id}/billingAccounts/{billing_account_id}.", "location": "query", "type": "string" }, @@ -2178,7 +2178,7 @@ } } }, - "revision": "20230611", + "revision": "20230613", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -3580,7 +3580,7 @@ "id": "GoogleCloudChannelV1ListTransferableOffersRequest", "properties": { "billingAccount": { - "description": "Optional. The Billing Account to look up Offers for. Format: accounts/{account_id}/billing_accounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.", + "description": "Optional. The Billing Account to look up Offers for. Format: accounts/{account_id}/billingAccounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.", "type": "string" }, "cloudIdentityId": { diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index 6f4e69af2fc..9623ad370d7 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -2612,7 +2612,7 @@ func (s *GoogleCloudChannelV1ListSubscribersResponse) MarshalJSON() ([]byte, err // for CloudChannelService.ListTransferableOffers type GoogleCloudChannelV1ListTransferableOffersRequest struct { // BillingAccount: Optional. The Billing Account to look up Offers for. - // Format: accounts/{account_id}/billing_accounts/{billing_account_id}. + // Format: accounts/{account_id}/billingAccounts/{billing_account_id}. // This field is only relevant for multi-currency accounts. It should be // left empty for single currency accounts. BillingAccount string `json:"billingAccount,omitempty"` @@ -10924,7 +10924,7 @@ func (r *AccountsCustomersService) ListPurchasableOffers(customer string) *Accou // "changeOfferPurchase.billingAccount": Resource name of the new target // Billing Account. Provide this Billing Account when setting up billing // for a trial subscription. Format: -// accounts/{account_id}/billing_accounts/{billing_account_id}. This +// accounts/{account_id}/billingAccounts/{billing_account_id}. This // field is only relevant for multi-currency accounts. It should be left // empty for single currency accounts. func (c *AccountsCustomersListPurchasableOffersCall) ChangeOfferPurchaseBillingAccount(changeOfferPurchaseBillingAccount string) *AccountsCustomersListPurchasableOffersCall { @@ -10954,7 +10954,7 @@ func (c *AccountsCustomersListPurchasableOffersCall) ChangeOfferPurchaseNewSku(c // CreateEntitlementPurchaseBillingAccount sets the optional parameter // "createEntitlementPurchase.billingAccount": Billing account that the // result should be restricted to. Format: -// accounts/{account_id}/billing_accounts/{billing_account_id}. +// accounts/{account_id}/billingAccounts/{billing_account_id}. func (c *AccountsCustomersListPurchasableOffersCall) CreateEntitlementPurchaseBillingAccount(createEntitlementPurchaseBillingAccount string) *AccountsCustomersListPurchasableOffersCall { c.urlParams_.Set("createEntitlementPurchase.billingAccount", createEntitlementPurchaseBillingAccount) return c @@ -11103,7 +11103,7 @@ func (c *AccountsCustomersListPurchasableOffersCall) Do(opts ...googleapi.CallOp // ], // "parameters": { // "changeOfferPurchase.billingAccount": { - // "description": "Optional. Resource name of the new target Billing Account. Provide this Billing Account when setting up billing for a trial subscription. Format: accounts/{account_id}/billing_accounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.", + // "description": "Optional. Resource name of the new target Billing Account. Provide this Billing Account when setting up billing for a trial subscription. Format: accounts/{account_id}/billingAccounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.", // "location": "query", // "type": "string" // }, @@ -11118,7 +11118,7 @@ func (c *AccountsCustomersListPurchasableOffersCall) Do(opts ...googleapi.CallOp // "type": "string" // }, // "createEntitlementPurchase.billingAccount": { - // "description": "Optional. Billing account that the result should be restricted to. Format: accounts/{account_id}/billing_accounts/{billing_account_id}.", + // "description": "Optional. Billing account that the result should be restricted to. Format: accounts/{account_id}/billingAccounts/{billing_account_id}.", // "location": "query", // "type": "string" // }, diff --git a/clouddebugger/v2/clouddebugger-api.json b/clouddebugger/v2/clouddebugger-api.json index 5e09da229cb..623b35b5937 100644 --- a/clouddebugger/v2/clouddebugger-api.json +++ b/clouddebugger/v2/clouddebugger-api.json @@ -15,7 +15,7 @@ "baseUrl": "https://clouddebugger.googleapis.com/", "batchPath": "batch", "canonicalName": "Cloud Debugger", - "description": "Examines the call stack and variables of a running application without stopping or slowing it down. ", + "description": "Examines the call stack and variables of a running application without stopping or slowing it down. (Deprecated) ", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/debugger", "fullyEncodeReservedExpansion": true, @@ -449,7 +449,7 @@ } } }, - "revision": "20230605", + "revision": "20230613", "rootUrl": "https://clouddebugger.googleapis.com/", "schemas": { "AliasContext": { @@ -1121,7 +1121,7 @@ } }, "servicePath": "", - "title": "Cloud Debugger API", + "title": "Cloud Debugger API (Deprecated)", "version": "v2", "version_module": true } \ No newline at end of file diff --git a/clouddebugger/v2/clouddebugger-gen.go b/clouddebugger/v2/clouddebugger-gen.go index bd1a8f5f06a..dcf09e85504 100644 --- a/clouddebugger/v2/clouddebugger-gen.go +++ b/clouddebugger/v2/clouddebugger-gen.go @@ -4,7 +4,7 @@ // Code generated file. DO NOT EDIT. -// Package clouddebugger provides access to the Cloud Debugger API. +// Package clouddebugger provides access to the Cloud Debugger API (Deprecated). // // For product documentation, see: https://cloud.google.com/debugger // diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index 6510bef2139..1460d66fd55 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -2433,7 +2433,7 @@ } } }, - "revision": "20230603", + "revision": "20230610", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -2642,11 +2642,11 @@ "type": "string" }, "newStartPageToken": { - "description": "The starting page token for future changes. This will be present only if the end of the current changes list has been reached.", + "description": "The starting page token for future changes. This will be present only if the end of the current changes list has been reached. The page token doesn't expire.", "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of changes. This will be absent if the end of the changes list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of changes. This will be absent if the end of the changes list has been reached. The page token doesn't expire.", "type": "string" } }, @@ -2798,7 +2798,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of comments. This will be absent if the end of the comments list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of comments. This will be absent if the end of the comments list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" } }, @@ -3031,7 +3031,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of shared drives. This will be absent if the end of the list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of shared drives. This will be absent if the end of the list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" } }, @@ -3690,7 +3690,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of files. This will be absent if the end of the files list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of files. This will be absent if the end of the files list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" } }, @@ -3873,7 +3873,7 @@ "type": "array" }, "nextPageToken": { - "description": "The page token for the next page of labels. This field will be absent if the end of the list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of labels. This field will be absent if the end of the list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" } }, @@ -4079,7 +4079,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of permissions. This field will be absent if the end of the permissions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of permissions. This field will be absent if the end of the permissions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" }, "permissions": { @@ -4153,7 +4153,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of replies. This will be absent if the end of the replies list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of replies. This will be absent if the end of the replies list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" }, "replies": { @@ -4245,7 +4245,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of revisions. This will be absent if the end of the revisions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of revisions. This will be absent if the end of the revisions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" }, "revisions": { @@ -4267,7 +4267,7 @@ "type": "string" }, "startPageToken": { - "description": "The starting page token for listing changes.", + "description": "The starting page token for listing future changes. The page token doesn't expire.", "type": "string" } }, @@ -4465,7 +4465,7 @@ "type": "string" }, "nextPageToken": { - "description": "The page token for the next page of Team Drives. This will be absent if the end of the Team Drives list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.", + "description": "The page token for the next page of Team Drives. This will be absent if the end of the Team Drives list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.", "type": "string" }, "teamDrives": { diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index 5170a012b18..0a9444ee92b 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -547,13 +547,12 @@ type ChangeList struct { // NewStartPageToken: The starting page token for future changes. This // will be present only if the end of the current changes list has been - // reached. + // reached. The page token doesn't expire. NewStartPageToken string `json:"newStartPageToken,omitempty"` // NextPageToken: The page token for the next page of changes. This will - // be absent if the end of the changes list has been reached. If the - // token is rejected for any reason, it should be discarded, and - // pagination should be restarted from the first page of results. + // be absent if the end of the changes list has been reached. The page + // token doesn't expire. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -775,7 +774,9 @@ type CommentList struct { // NextPageToken: The page token for the next page of comments. This // will be absent if the end of the comments list has been reached. If // the token is rejected for any reason, it should be discarded, and - // pagination should be restarted from the first page of results. + // pagination should be restarted from the first page of results. The + // page token is typically valid for several hours. However, if new + // items are added or removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1192,7 +1193,9 @@ type DriveList struct { // NextPageToken: The page token for the next page of shared drives. // This will be absent if the end of the list has been reached. If the // token is rejected for any reason, it should be discarded, and - // pagination should be restarted from the first page of results. + // pagination should be restarted from the first page of results. The + // page token is typically valid for several hours. However, if new + // items are added or removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2154,7 +2157,9 @@ type FileList struct { // NextPageToken: The page token for the next page of files. This will // be absent if the end of the files list has been reached. If the token // is rejected for any reason, it should be discarded, and pagination - // should be restarted from the first page of results. + // should be restarted from the first page of results. The page token is + // typically valid for several hours. However, if new items are added or + // removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2379,7 +2384,9 @@ type LabelList struct { // NextPageToken: The page token for the next page of labels. This field // will be absent if the end of the list has been reached. If the token // is rejected for any reason, it should be discarded, and pagination - // should be restarted from the first page of results. + // should be restarted from the first page of results. The page token is + // typically valid for several hours. However, if new items are added or + // removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2720,7 +2727,9 @@ type PermissionList struct { // field will be absent if the end of the permissions list has been // reached. If the token is rejected for any reason, it should be // discarded, and pagination should be restarted from the first page of - // results. + // results. The page token is typically valid for several hours. + // However, if new items are added or removed, your expected results + // might differ. NextPageToken string `json:"nextPageToken,omitempty"` // Permissions: The list of permissions. If nextPageToken is populated, @@ -2829,7 +2838,9 @@ type ReplyList struct { // NextPageToken: The page token for the next page of replies. This will // be absent if the end of the replies list has been reached. If the // token is rejected for any reason, it should be discarded, and - // pagination should be restarted from the first page of results. + // pagination should be restarted from the first page of results. The + // page token is typically valid for several hours. However, if new + // items are added or removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // Replies: The list of replies. If nextPageToken is populated, then @@ -2960,7 +2971,9 @@ type RevisionList struct { // NextPageToken: The page token for the next page of revisions. This // will be absent if the end of the revisions list has been reached. If // the token is rejected for any reason, it should be discarded, and - // pagination should be restarted from the first page of results. + // pagination should be restarted from the first page of results. The + // page token is typically valid for several hours. However, if new + // items are added or removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // Revisions: The list of revisions. If nextPageToken is populated, then @@ -3000,7 +3013,8 @@ type StartPageToken struct { // string "drive#startPageToken". Kind string `json:"kind,omitempty"` - // StartPageToken: The starting page token for listing changes. + // StartPageToken: The starting page token for listing future changes. + // The page token doesn't expire. StartPageToken string `json:"startPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3359,7 +3373,9 @@ type TeamDriveList struct { // NextPageToken: The page token for the next page of Team Drives. This // will be absent if the end of the Team Drives list has been reached. // If the token is rejected for any reason, it should be discarded, and - // pagination should be restarted from the first page of results. + // pagination should be restarted from the first page of results. The + // page token is typically valid for several hours. However, if new + // items are added or removed, your expected results might differ. NextPageToken string `json:"nextPageToken,omitempty"` // TeamDrives: The list of Team Drives. If nextPageToken is populated, diff --git a/gmail/v1/gmail-api.json b/gmail/v1/gmail-api.json index 275c8408b3c..e633895b74b 100644 --- a/gmail/v1/gmail-api.json +++ b/gmail/v1/gmail-api.json @@ -3077,7 +3077,7 @@ } } }, - "revision": "20230515", + "revision": "20230612", "rootUrl": "https://gmail.googleapis.com/", "schemas": { "AutoForwarding": { @@ -4359,6 +4359,18 @@ ], "type": "string" }, + "labelFilterBehavior": { + "description": "Filtering behavior of labelIds list specified. This field replaces label_filter_action; if set, label_filter_action is ignored.", + "enum": [ + "include", + "exclude" + ], + "enumDescriptions": [ + "Only get push notifications for message changes relating to labelIds specified.", + "Get push notifications for all message changes except those relating to labelIds specified." + ], + "type": "string" + }, "labelIds": { "description": "List of label_ids to restrict notifications about. By default, if unspecified, all changes are pushed out. If specified then dictates which labels are required for a push notification to be generated.", "items": { diff --git a/gmail/v1/gmail-gen.go b/gmail/v1/gmail-gen.go index 1b88cf4732a..dc2ced596dc 100644 --- a/gmail/v1/gmail-gen.go +++ b/gmail/v1/gmail-gen.go @@ -2490,6 +2490,17 @@ type WatchRequest struct { // those relating to labelIds specified. LabelFilterAction string `json:"labelFilterAction,omitempty"` + // LabelFilterBehavior: Filtering behavior of labelIds list specified. + // This field replaces label_filter_action; if set, label_filter_action + // is ignored. + // + // Possible values: + // "include" - Only get push notifications for message changes + // relating to labelIds specified. + // "exclude" - Get push notifications for all message changes except + // those relating to labelIds specified. + LabelFilterBehavior string `json:"labelFilterBehavior,omitempty"` + // LabelIds: List of label_ids to restrict notifications about. By // default, if unspecified, all changes are pushed out. If specified // then dictates which labels are required for a push notification to be diff --git a/recommender/v1beta1/recommender-api.json b/recommender/v1beta1/recommender-api.json index 3764387344c..b98ef58500c 100644 --- a/recommender/v1beta1/recommender-api.json +++ b/recommender/v1beta1/recommender-api.json @@ -829,6 +829,37 @@ } } }, + "insightTypes": { + "methods": { + "list": { + "description": "Lists available InsightTypes. No IAM permissions are required.", + "flatPath": "v1beta1/insightTypes", + "httpMethod": "GET", + "id": "recommender.insightTypes.list", + "parameterOrder": [], + "parameters": { + "pageSize": { + "description": "Optional. The number of InsightTypes to return per page. The service may return fewer than this value.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListRecommenders` call. Provide this to retrieve the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/insightTypes", + "response": { + "$ref": "GoogleCloudRecommenderV1beta1ListInsightTypesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "organizations": { "resources": { "locations": { @@ -1684,9 +1715,40 @@ } } } + }, + "recommenders": { + "methods": { + "list": { + "description": "Lists all available Recommenders. No IAM permissions are required.", + "flatPath": "v1beta1/recommenders", + "httpMethod": "GET", + "id": "recommender.recommenders.list", + "parameterOrder": [], + "parameters": { + "pageSize": { + "description": "Optional. The number of RecommenderTypes to return per page. The service may return fewer than this value.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListRecommenders` call. Provide this to retrieve the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/recommenders", + "response": { + "$ref": "GoogleCloudRecommenderV1beta1ListRecommendersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } }, - "revision": "20230108", + "revision": "20230612", "rootUrl": "https://recommender.googleapis.com/", "schemas": { "GoogleCloudRecommenderV1beta1CostProjection": { @@ -1890,6 +1952,17 @@ }, "type": "object" }, + "GoogleCloudRecommenderV1beta1InsightType": { + "description": "The type of insight. See google3/googledata/devsite/site-cloud/en/recommender/docs/insights/insight-types.md for more info.", + "id": "GoogleCloudRecommenderV1beta1InsightType", + "properties": { + "name": { + "description": "The insight_type’s name in format insightTypes/{insight_type} eg: insightTypes/google.iam.policy.Insight", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRecommenderV1beta1InsightTypeConfig": { "description": "Configuration for an InsightType.", "id": "GoogleCloudRecommenderV1beta1InsightTypeConfig", @@ -1945,6 +2018,24 @@ }, "type": "object" }, + "GoogleCloudRecommenderV1beta1ListInsightTypesResponse": { + "description": "Response for the `ListInsightTypes` method. Next ID: 3", + "id": "GoogleCloudRecommenderV1beta1ListInsightTypesResponse", + "properties": { + "insightTypes": { + "description": "The set of recommenders available", + "items": { + "$ref": "GoogleCloudRecommenderV1beta1InsightType" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRecommenderV1beta1ListInsightsResponse": { "description": "Response to the `ListInsights` method.", "id": "GoogleCloudRecommenderV1beta1ListInsightsResponse", @@ -1981,6 +2072,24 @@ }, "type": "object" }, + "GoogleCloudRecommenderV1beta1ListRecommendersResponse": { + "description": "Response for the `ListRecommender` method. Next ID: 3", + "id": "GoogleCloudRecommenderV1beta1ListRecommendersResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "recommenders": { + "description": "The set of recommenders available", + "items": { + "$ref": "GoogleCloudRecommenderV1beta1RecommenderType" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRecommenderV1beta1MarkInsightAcceptedRequest": { "description": "Request for the `MarkInsightAccepted` method.", "id": "GoogleCloudRecommenderV1beta1MarkInsightAcceptedRequest", @@ -2329,6 +2438,17 @@ }, "type": "object" }, + "GoogleCloudRecommenderV1beta1RecommenderType": { + "description": "The type of a recommender. See google3/googledata/devsite/site-cloud/en/recommender/docs/recommenders.md for more info.", + "id": "GoogleCloudRecommenderV1beta1RecommenderType", + "properties": { + "name": { + "description": "The recommender's name in format RecommenderTypes/{recommender_type} eg: recommenderTypes/google.iam.policy.Recommender", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRecommenderV1beta1ReliabilityProjection": { "description": "Contains information on the impact of a reliability recommendation.", "id": "GoogleCloudRecommenderV1beta1ReliabilityProjection", diff --git a/recommender/v1beta1/recommender-gen.go b/recommender/v1beta1/recommender-gen.go index 411e91ea32b..28292e50471 100644 --- a/recommender/v1beta1/recommender-gen.go +++ b/recommender/v1beta1/recommender-gen.go @@ -121,8 +121,10 @@ func New(client *http.Client) (*Service, error) { s := &Service{client: client, BasePath: basePath} s.BillingAccounts = NewBillingAccountsService(s) s.Folders = NewFoldersService(s) + s.InsightTypes = NewInsightTypesService(s) s.Organizations = NewOrganizationsService(s) s.Projects = NewProjectsService(s) + s.Recommenders = NewRecommendersService(s) return s, nil } @@ -135,9 +137,13 @@ type Service struct { Folders *FoldersService + InsightTypes *InsightTypesService + Organizations *OrganizationsService Projects *ProjectsService + + Recommenders *RecommendersService } func (s *Service) userAgent() string { @@ -285,6 +291,15 @@ type FoldersLocationsRecommendersRecommendationsService struct { s *Service } +func NewInsightTypesService(s *Service) *InsightTypesService { + rs := &InsightTypesService{s: s} + return rs +} + +type InsightTypesService struct { + s *Service +} + func NewOrganizationsService(s *Service) *OrganizationsService { rs := &OrganizationsService{s: s} rs.Locations = NewOrganizationsLocationsService(s) @@ -423,6 +438,15 @@ type ProjectsLocationsRecommendersRecommendationsService struct { s *Service } +func NewRecommendersService(s *Service) *RecommendersService { + rs := &RecommendersService{s: s} + return rs +} + +type RecommendersService struct { + s *Service +} + // GoogleCloudRecommenderV1beta1CostProjection: Contains metadata about // how much money a recommendation can save or incur. type GoogleCloudRecommenderV1beta1CostProjection struct { @@ -687,6 +711,37 @@ func (s *GoogleCloudRecommenderV1beta1InsightStateInfo) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRecommenderV1beta1InsightType: The type of insight. See +// google3/googledata/devsite/site-cloud/en/recommender/docs/insights/ins +// ight-types.md for more info. +type GoogleCloudRecommenderV1beta1InsightType struct { + // Name: The insight_type’s name in format insightTypes/{insight_type} + // eg: insightTypes/google.iam.policy.Insight + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") 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. "Name") 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 *GoogleCloudRecommenderV1beta1InsightType) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecommenderV1beta1InsightType + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecommenderV1beta1InsightTypeConfig: Configuration for an // InsightType. type GoogleCloudRecommenderV1beta1InsightTypeConfig struct { @@ -782,6 +837,44 @@ func (s *GoogleCloudRecommenderV1beta1InsightTypeGenerationConfig) MarshalJSON() return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRecommenderV1beta1ListInsightTypesResponse: Response for +// the `ListInsightTypes` method. Next ID: 3 +type GoogleCloudRecommenderV1beta1ListInsightTypesResponse struct { + // InsightTypes: The set of recommenders available + InsightTypes []*GoogleCloudRecommenderV1beta1InsightType `json:"insightTypes,omitempty"` + + // NextPageToken: A token, which can be sent as `page_token` to retrieve + // the next page. If this field is omitted, there are no subsequent + // pages. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "InsightTypes") 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. "InsightTypes") 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 *GoogleCloudRecommenderV1beta1ListInsightTypesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecommenderV1beta1ListInsightTypesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecommenderV1beta1ListInsightsResponse: Response to the // `ListInsights` method. type GoogleCloudRecommenderV1beta1ListInsightsResponse struct { @@ -857,6 +950,44 @@ func (s *GoogleCloudRecommenderV1beta1ListRecommendationsResponse) MarshalJSON() return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRecommenderV1beta1ListRecommendersResponse: Response for +// the `ListRecommender` method. Next ID: 3 +type GoogleCloudRecommenderV1beta1ListRecommendersResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve + // the next page. If this field is omitted, there are no subsequent + // pages. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Recommenders: The set of recommenders available + Recommenders []*GoogleCloudRecommenderV1beta1RecommenderType `json:"recommenders,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 *GoogleCloudRecommenderV1beta1ListRecommendersResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecommenderV1beta1ListRecommendersResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecommenderV1beta1MarkInsightAcceptedRequest: Request for // the `MarkInsightAccepted` method. type GoogleCloudRecommenderV1beta1MarkInsightAcceptedRequest struct { @@ -1459,6 +1590,39 @@ func (s *GoogleCloudRecommenderV1beta1RecommenderGenerationConfig) MarshalJSON() return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRecommenderV1beta1RecommenderType: The type of a +// recommender. See +// google3/googledata/devsite/site-cloud/en/recommender/docs/recommenders +// .md for more info. +type GoogleCloudRecommenderV1beta1RecommenderType struct { + // Name: The recommender's name in format + // RecommenderTypes/{recommender_type} eg: + // recommenderTypes/google.iam.policy.Recommender + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") 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. "Name") 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 *GoogleCloudRecommenderV1beta1RecommenderType) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecommenderV1beta1RecommenderType + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecommenderV1beta1ReliabilityProjection: Contains // information on the impact of a reliability recommendation. type GoogleCloudRecommenderV1beta1ReliabilityProjection struct { @@ -5336,6 +5500,186 @@ func (c *FoldersLocationsRecommendersRecommendationsMarkSucceededCall) Do(opts . } +// method id "recommender.insightTypes.list": + +type InsightTypesListCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists available InsightTypes. No IAM permissions are required. +func (r *InsightTypesService) List() *InsightTypesListCall { + c := &InsightTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + return c +} + +// PageSize sets the optional parameter "pageSize": The number of +// InsightTypes to return per page. The service may return fewer than +// this value. +func (c *InsightTypesListCall) PageSize(pageSize int64) *InsightTypesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListRecommenders` call. Provide this to +// retrieve the subsequent page. +func (c *InsightTypesListCall) PageToken(pageToken string) *InsightTypesListCall { + 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 *InsightTypesListCall) Fields(s ...googleapi.Field) *InsightTypesListCall { + 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 *InsightTypesListCall) IfNoneMatch(entityTag string) *InsightTypesListCall { + 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 *InsightTypesListCall) Context(ctx context.Context) *InsightTypesListCall { + 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 *InsightTypesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InsightTypesListCall) 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, "v1beta1/insightTypes") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "recommender.insightTypes.list" call. +// Exactly one of *GoogleCloudRecommenderV1beta1ListInsightTypesResponse +// or error will be non-nil. Any non-2xx status code is an error. +// Response headers are in either +// *GoogleCloudRecommenderV1beta1ListInsightTypesResponse.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 *InsightTypesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1beta1ListInsightTypesResponse, 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 := &GoogleCloudRecommenderV1beta1ListInsightTypesResponse{ + 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 available InsightTypes. No IAM permissions are required.", + // "flatPath": "v1beta1/insightTypes", + // "httpMethod": "GET", + // "id": "recommender.insightTypes.list", + // "parameterOrder": [], + // "parameters": { + // "pageSize": { + // "description": "Optional. The number of InsightTypes to return per page. The service may return fewer than this value.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. A page token, received from a previous `ListRecommenders` call. Provide this to retrieve the subsequent page.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta1/insightTypes", + // "response": { + // "$ref": "GoogleCloudRecommenderV1beta1ListInsightTypesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *InsightTypesListCall) Pages(ctx context.Context, f func(*GoogleCloudRecommenderV1beta1ListInsightTypesResponse) 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 "recommender.organizations.locations.insightTypes.getConfig": type OrganizationsLocationsInsightTypesGetConfigCall struct { @@ -9681,3 +10025,184 @@ func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Do(opts // } } + +// method id "recommender.recommenders.list": + +type RecommendersListCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all available Recommenders. No IAM permissions are +// required. +func (r *RecommendersService) List() *RecommendersListCall { + c := &RecommendersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + return c +} + +// PageSize sets the optional parameter "pageSize": The number of +// RecommenderTypes to return per page. The service may return fewer +// than this value. +func (c *RecommendersListCall) PageSize(pageSize int64) *RecommendersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListRecommenders` call. Provide this to +// retrieve the subsequent page. +func (c *RecommendersListCall) PageToken(pageToken string) *RecommendersListCall { + 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 *RecommendersListCall) Fields(s ...googleapi.Field) *RecommendersListCall { + 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 *RecommendersListCall) IfNoneMatch(entityTag string) *RecommendersListCall { + 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 *RecommendersListCall) Context(ctx context.Context) *RecommendersListCall { + 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 *RecommendersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RecommendersListCall) 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, "v1beta1/recommenders") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "recommender.recommenders.list" call. +// Exactly one of *GoogleCloudRecommenderV1beta1ListRecommendersResponse +// or error will be non-nil. Any non-2xx status code is an error. +// Response headers are in either +// *GoogleCloudRecommenderV1beta1ListRecommendersResponse.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 *RecommendersListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1beta1ListRecommendersResponse, 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 := &GoogleCloudRecommenderV1beta1ListRecommendersResponse{ + 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 available Recommenders. No IAM permissions are required.", + // "flatPath": "v1beta1/recommenders", + // "httpMethod": "GET", + // "id": "recommender.recommenders.list", + // "parameterOrder": [], + // "parameters": { + // "pageSize": { + // "description": "Optional. The number of RecommenderTypes to return per page. The service may return fewer than this value.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. A page token, received from a previous `ListRecommenders` call. Provide this to retrieve the subsequent page.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta1/recommenders", + // "response": { + // "$ref": "GoogleCloudRecommenderV1beta1ListRecommendersResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *RecommendersListCall) Pages(ctx context.Context, f func(*GoogleCloudRecommenderV1beta1ListRecommendersResponse) 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) + } +} diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index 5ca57bbb373..1c609eeb9df 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -790,6 +790,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "purge": { + "description": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by ProductService.GetProduct or ProductService.ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:purge", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.purge", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The resource name of the branch under which the products are created. The format is `projects/${projectId}/locations/global/catalogs/${catalogId}/branches/${branchId}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/products:purge", + "request": { + "$ref": "GoogleCloudRetailV2PurgeProductsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "removeFulfillmentPlaces": { "description": "We recommend that you use the ProductService.RemoveLocalInventories method instead of the ProductService.RemoveFulfillmentPlaces method. ProductService.RemoveLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", @@ -2031,7 +2059,7 @@ } } }, - "revision": "20230525", + "revision": "20230609", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -3896,6 +3924,67 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2PurgeProductsMetadata": { + "description": "Metadata related to the progress of the PurgeProducts operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudRetailV2PurgeProductsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2PurgeProductsRequest": { + "description": "Request message for PurgeProducts method.", + "id": "GoogleCloudRetailV2PurgeProductsRequest", + "properties": { + "filter": { + "description": "Required. The filter string to specify the products to be deleted with a length limit of 5,000 characters. Empty string filter is not allowed. \"*\" implies delete all items in a branch. The eligible fields for filtering are: * `availability`: Double quoted Product.availability string. * `create_time` : in ISO 8601 \"zulu\" format. Supported syntax: * Comparators (\"\u003e\", \"\u003c\", \"\u003e=\", \"\u003c=\", \"=\"). Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" * availability = \"IN_STOCK\" * Conjunctions (\"AND\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\" * Disjunctions (\"OR\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"IN_STOCK\" * Can support nested queries. Examples: * (create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\") OR (create_time \u003e= \"2015-02-14T13:03:32Z\" AND availability = \"IN_STOCK\") * Filter Limits: * Filter should not contain more than 6 conditions. * Max nesting depth should not exceed 2 levels. Examples queries: * Delete back order products created before a timestamp. create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"BACKORDER\"", + "type": "string" + }, + "force": { + "description": "Actually perform the purge. If `force` is set to false, the method will return the expected purge count without deleting any products.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2PurgeProductsResponse": { + "description": "Response of the PurgeProductsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudRetailV2PurgeProductsResponse", + "properties": { + "purgeCount": { + "description": "The total count of products purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of the product names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2PurgeUserEventsRequest": { "description": "Request message for PurgeUserEvents method.", "id": "GoogleCloudRetailV2PurgeUserEventsRequest", @@ -6498,6 +6587,52 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaPurgeProductsMetadata": { + "description": "Metadata related to the progress of the PurgeProducts operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudRetailV2betaPurgeProductsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaPurgeProductsResponse": { + "description": "Response of the PurgeProductsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudRetailV2betaPurgeProductsResponse", + "properties": { + "purgeCount": { + "description": "The total count of products purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of the product names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaPurgeUserEventsResponse": { "description": "Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", "id": "GoogleCloudRetailV2betaPurgeUserEventsResponse", diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 839108d36cc..150887241d6 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -3931,6 +3931,134 @@ func (s *GoogleCloudRetailV2PurchaseTransaction) UnmarshalJSON(data []byte) erro type GoogleCloudRetailV2PurgeMetadata struct { } +// GoogleCloudRetailV2PurgeProductsMetadata: Metadata related to the +// progress of the PurgeProducts operation. This will be returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudRetailV2PurgeProductsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 *GoogleCloudRetailV2PurgeProductsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2PurgeProductsRequest: Request message for +// PurgeProducts method. +type GoogleCloudRetailV2PurgeProductsRequest struct { + // Filter: Required. The filter string to specify the products to be + // deleted with a length limit of 5,000 characters. Empty string filter + // is not allowed. "*" implies delete all items in a branch. The + // eligible fields for filtering are: * `availability`: Double quoted + // Product.availability string. * `create_time` : in ISO 8601 "zulu" + // format. Supported syntax: * Comparators (">", "<", ">=", "<=", "="). + // Examples: * create_time <= "2015-02-13T17:05:46Z" * availability = + // "IN_STOCK" * Conjunctions ("AND") Examples: * create_time <= + // "2015-02-13T17:05:46Z" AND availability = "PREORDER" * Disjunctions + // ("OR") Examples: * create_time <= "2015-02-13T17:05:46Z" OR + // availability = "IN_STOCK" * Can support nested queries. Examples: * + // (create_time <= "2015-02-13T17:05:46Z" AND availability = "PREORDER") + // OR (create_time >= "2015-02-14T13:03:32Z" AND availability = + // "IN_STOCK") * Filter Limits: * Filter should not contain more than 6 + // conditions. * Max nesting depth should not exceed 2 levels. Examples + // queries: * Delete back order products created before a timestamp. + // create_time <= "2015-02-13T17:05:46Z" OR availability = "BACKORDER" + Filter string `json:"filter,omitempty"` + + // Force: Actually perform the purge. If `force` is set to false, the + // method will return the expected purge count without deleting any + // products. + Force bool `json:"force,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Filter") 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. "Filter") 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 *GoogleCloudRetailV2PurgeProductsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2PurgeProductsResponse: Response of the +// PurgeProductsRequest. If the long running operation is successfully +// done, then this message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudRetailV2PurgeProductsResponse struct { + // PurgeCount: The total count of products purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of the product names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") 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. "PurgeCount") 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 *GoogleCloudRetailV2PurgeProductsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2PurgeUserEventsRequest: Request message for // PurgeUserEvents method. type GoogleCloudRetailV2PurgeUserEventsRequest struct { @@ -8783,6 +8911,84 @@ func (s *GoogleCloudRetailV2betaOutputResult) MarshalJSON() ([]byte, error) { type GoogleCloudRetailV2betaPurgeMetadata struct { } +// GoogleCloudRetailV2betaPurgeProductsMetadata: Metadata related to the +// progress of the PurgeProducts operation. This will be returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudRetailV2betaPurgeProductsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 *GoogleCloudRetailV2betaPurgeProductsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaPurgeProductsResponse: Response of the +// PurgeProductsRequest. If the long running operation is successfully +// done, then this message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudRetailV2betaPurgeProductsResponse struct { + // PurgeCount: The total count of products purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of the product names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") 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. "PurgeCount") 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 *GoogleCloudRetailV2betaPurgeProductsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaPurgeUserEventsResponse: Response of the // PurgeUserEventsRequest. If the long running operation is successfully // done, then this message is returned by the @@ -12670,6 +12876,159 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) Do(opts ...googleap } +// method id "retail.projects.locations.catalogs.branches.products.purge": + +type ProjectsLocationsCatalogsBranchesProductsPurgeCall struct { + s *Service + parent string + googlecloudretailv2purgeproductsrequest *GoogleCloudRetailV2PurgeProductsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Purge: Permanently deletes all selected Products under a branch. This +// process is asynchronous. If the request is valid, the removal will be +// enqueued and processed offline. Depending on the number of Products, +// this operation could take hours to complete. Before the operation +// completes, some Products may still be returned by +// ProductService.GetProduct or ProductService.ListProducts. Depending +// on the number of Products, this operation could take hours to +// complete. To get a sample of Products that would be deleted, set +// PurgeProductsRequest.force to false. +// +// - parent: The resource name of the branch under which the products +// are created. The format is +// `projects/${projectId}/locations/global/catalogs/${catalogId}/branch +// es/${branchId}`. +func (r *ProjectsLocationsCatalogsBranchesProductsService) Purge(parent string, googlecloudretailv2purgeproductsrequest *GoogleCloudRetailV2PurgeProductsRequest) *ProjectsLocationsCatalogsBranchesProductsPurgeCall { + c := &ProjectsLocationsCatalogsBranchesProductsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudretailv2purgeproductsrequest = googlecloudretailv2purgeproductsrequest + 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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsPurgeCall { + 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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsPurgeCall { + 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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsPurgeCall) 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.googlecloudretailv2purgeproductsrequest) + 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/{+parent}/products:purge") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", 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 "retail.projects.locations.catalogs.branches.products.purge" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, 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 := &GoogleLongrunningOperation{ + 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": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by ProductService.GetProduct or ProductService.ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:purge", + // "httpMethod": "POST", + // "id": "retail.projects.locations.catalogs.branches.products.purge", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The resource name of the branch under which the products are created. The format is `projects/${projectId}/locations/global/catalogs/${catalogId}/branches/${branchId}`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/products:purge", + // "request": { + // "$ref": "GoogleCloudRetailV2PurgeProductsRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces": type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct { diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index d402b62ea2e..efa8cf73330 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -2217,7 +2217,7 @@ } } }, - "revision": "20230525", + "revision": "20230609", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2691,6 +2691,52 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2PurgeProductsMetadata": { + "description": "Metadata related to the progress of the PurgeProducts operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudRetailV2PurgeProductsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2PurgeProductsResponse": { + "description": "Response of the PurgeProductsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudRetailV2PurgeProductsResponse", + "properties": { + "purgeCount": { + "description": "The total count of products purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of the product names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2PurgeUserEventsResponse": { "description": "Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", "id": "GoogleCloudRetailV2PurgeUserEventsResponse", @@ -6898,6 +6944,52 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaPurgeProductsMetadata": { + "description": "Metadata related to the progress of the PurgeProducts operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudRetailV2betaPurgeProductsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaPurgeProductsResponse": { + "description": "Response of the PurgeProductsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudRetailV2betaPurgeProductsResponse", + "properties": { + "purgeCount": { + "description": "The total count of products purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of the product names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaPurgeUserEventsResponse": { "description": "Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", "id": "GoogleCloudRetailV2betaPurgeUserEventsResponse", diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index a69312fee94..237a8b1f999 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -1188,6 +1188,84 @@ func (s *GoogleCloudRetailV2ModelServingConfigList) MarshalJSON() ([]byte, error type GoogleCloudRetailV2PurgeMetadata struct { } +// GoogleCloudRetailV2PurgeProductsMetadata: Metadata related to the +// progress of the PurgeProducts operation. This will be returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudRetailV2PurgeProductsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 *GoogleCloudRetailV2PurgeProductsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2PurgeProductsResponse: Response of the +// PurgeProductsRequest. If the long running operation is successfully +// done, then this message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudRetailV2PurgeProductsResponse struct { + // PurgeCount: The total count of products purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of the product names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") 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. "PurgeCount") 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 *GoogleCloudRetailV2PurgeProductsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2PurgeUserEventsResponse: Response of the // PurgeUserEventsRequest. If the long running operation is successfully // done, then this message is returned by the @@ -9226,6 +9304,84 @@ func (s *GoogleCloudRetailV2betaOutputResult) MarshalJSON() ([]byte, error) { type GoogleCloudRetailV2betaPurgeMetadata struct { } +// GoogleCloudRetailV2betaPurgeProductsMetadata: Metadata related to the +// progress of the PurgeProducts operation. This will be returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudRetailV2betaPurgeProductsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 *GoogleCloudRetailV2betaPurgeProductsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaPurgeProductsResponse: Response of the +// PurgeProductsRequest. If the long running operation is successfully +// done, then this message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudRetailV2betaPurgeProductsResponse struct { + // PurgeCount: The total count of products purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of the product names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") 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. "PurgeCount") 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 *GoogleCloudRetailV2betaPurgeProductsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaPurgeUserEventsResponse: Response of the // PurgeUserEventsRequest. If the long running operation is successfully // done, then this message is returned by the diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 1ad134b3078..cd1ad286859 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -818,6 +818,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "purge": { + "description": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by ProductService.GetProduct or ProductService.ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:purge", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.purge", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The resource name of the branch under which the products are created. The format is `projects/${projectId}/locations/global/catalogs/${catalogId}/branches/${branchId}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+parent}/products:purge", + "request": { + "$ref": "GoogleCloudRetailV2betaPurgeProductsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "removeFulfillmentPlaces": { "description": "We recommend that you use the ProductService.RemoveLocalInventories method instead of the ProductService.RemoveFulfillmentPlaces method. ProductService.RemoveLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", @@ -2059,7 +2087,7 @@ } } }, - "revision": "20230525", + "revision": "20230609", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2533,6 +2561,52 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2PurgeProductsMetadata": { + "description": "Metadata related to the progress of the PurgeProducts operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudRetailV2PurgeProductsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2PurgeProductsResponse": { + "description": "Response of the PurgeProductsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudRetailV2PurgeProductsResponse", + "properties": { + "purgeCount": { + "description": "The total count of products purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of the product names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2PurgeUserEventsResponse": { "description": "Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", "id": "GoogleCloudRetailV2PurgeUserEventsResponse", @@ -5469,6 +5543,67 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaPurgeProductsMetadata": { + "description": "Metadata related to the progress of the PurgeProducts operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudRetailV2betaPurgeProductsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaPurgeProductsRequest": { + "description": "Request message for PurgeProducts method.", + "id": "GoogleCloudRetailV2betaPurgeProductsRequest", + "properties": { + "filter": { + "description": "Required. The filter string to specify the products to be deleted with a length limit of 5,000 characters. Empty string filter is not allowed. \"*\" implies delete all items in a branch. The eligible fields for filtering are: * `availability`: Double quoted Product.availability string. * `create_time` : in ISO 8601 \"zulu\" format. Supported syntax: * Comparators (\"\u003e\", \"\u003c\", \"\u003e=\", \"\u003c=\", \"=\"). Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" * availability = \"IN_STOCK\" * Conjunctions (\"AND\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\" * Disjunctions (\"OR\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"IN_STOCK\" * Can support nested queries. Examples: * (create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\") OR (create_time \u003e= \"2015-02-14T13:03:32Z\" AND availability = \"IN_STOCK\") * Filter Limits: * Filter should not contain more than 6 conditions. * Max nesting depth should not exceed 2 levels. Examples queries: * Delete back order products created before a timestamp. create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"BACKORDER\"", + "type": "string" + }, + "force": { + "description": "Actually perform the purge. If `force` is set to false, the method will return the expected purge count without deleting any products.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaPurgeProductsResponse": { + "description": "Response of the PurgeProductsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudRetailV2betaPurgeProductsResponse", + "properties": { + "purgeCount": { + "description": "The total count of products purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of the product names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaPurgeUserEventsRequest": { "description": "Request message for PurgeUserEvents method.", "id": "GoogleCloudRetailV2betaPurgeUserEventsRequest", diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 366484e3601..137683da0ec 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -1152,6 +1152,84 @@ func (s *GoogleCloudRetailV2ModelServingConfigList) MarshalJSON() ([]byte, error type GoogleCloudRetailV2PurgeMetadata struct { } +// GoogleCloudRetailV2PurgeProductsMetadata: Metadata related to the +// progress of the PurgeProducts operation. This will be returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudRetailV2PurgeProductsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 *GoogleCloudRetailV2PurgeProductsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2PurgeProductsResponse: Response of the +// PurgeProductsRequest. If the long running operation is successfully +// done, then this message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudRetailV2PurgeProductsResponse struct { + // PurgeCount: The total count of products purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of the product names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") 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. "PurgeCount") 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 *GoogleCloudRetailV2PurgeProductsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PurgeProductsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2PurgeUserEventsResponse: Response of the // PurgeUserEventsRequest. If the long running operation is successfully // done, then this message is returned by the @@ -6698,6 +6776,134 @@ func (s *GoogleCloudRetailV2betaPurchaseTransaction) UnmarshalJSON(data []byte) type GoogleCloudRetailV2betaPurgeMetadata struct { } +// GoogleCloudRetailV2betaPurgeProductsMetadata: Metadata related to the +// progress of the PurgeProducts operation. This will be returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudRetailV2betaPurgeProductsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 *GoogleCloudRetailV2betaPurgeProductsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaPurgeProductsRequest: Request message for +// PurgeProducts method. +type GoogleCloudRetailV2betaPurgeProductsRequest struct { + // Filter: Required. The filter string to specify the products to be + // deleted with a length limit of 5,000 characters. Empty string filter + // is not allowed. "*" implies delete all items in a branch. The + // eligible fields for filtering are: * `availability`: Double quoted + // Product.availability string. * `create_time` : in ISO 8601 "zulu" + // format. Supported syntax: * Comparators (">", "<", ">=", "<=", "="). + // Examples: * create_time <= "2015-02-13T17:05:46Z" * availability = + // "IN_STOCK" * Conjunctions ("AND") Examples: * create_time <= + // "2015-02-13T17:05:46Z" AND availability = "PREORDER" * Disjunctions + // ("OR") Examples: * create_time <= "2015-02-13T17:05:46Z" OR + // availability = "IN_STOCK" * Can support nested queries. Examples: * + // (create_time <= "2015-02-13T17:05:46Z" AND availability = "PREORDER") + // OR (create_time >= "2015-02-14T13:03:32Z" AND availability = + // "IN_STOCK") * Filter Limits: * Filter should not contain more than 6 + // conditions. * Max nesting depth should not exceed 2 levels. Examples + // queries: * Delete back order products created before a timestamp. + // create_time <= "2015-02-13T17:05:46Z" OR availability = "BACKORDER" + Filter string `json:"filter,omitempty"` + + // Force: Actually perform the purge. If `force` is set to false, the + // method will return the expected purge count without deleting any + // products. + Force bool `json:"force,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Filter") 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. "Filter") 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 *GoogleCloudRetailV2betaPurgeProductsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaPurgeProductsResponse: Response of the +// PurgeProductsRequest. If the long running operation is successfully +// done, then this message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudRetailV2betaPurgeProductsResponse struct { + // PurgeCount: The total count of products purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of the product names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") 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. "PurgeCount") 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 *GoogleCloudRetailV2betaPurgeProductsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPurgeProductsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaPurgeUserEventsRequest: Request message for // PurgeUserEvents method. type GoogleCloudRetailV2betaPurgeUserEventsRequest struct { @@ -13064,6 +13270,159 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) Do(opts ...googleap } +// method id "retail.projects.locations.catalogs.branches.products.purge": + +type ProjectsLocationsCatalogsBranchesProductsPurgeCall struct { + s *Service + parent string + googlecloudretailv2betapurgeproductsrequest *GoogleCloudRetailV2betaPurgeProductsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Purge: Permanently deletes all selected Products under a branch. This +// process is asynchronous. If the request is valid, the removal will be +// enqueued and processed offline. Depending on the number of Products, +// this operation could take hours to complete. Before the operation +// completes, some Products may still be returned by +// ProductService.GetProduct or ProductService.ListProducts. Depending +// on the number of Products, this operation could take hours to +// complete. To get a sample of Products that would be deleted, set +// PurgeProductsRequest.force to false. +// +// - parent: The resource name of the branch under which the products +// are created. The format is +// `projects/${projectId}/locations/global/catalogs/${catalogId}/branch +// es/${branchId}`. +func (r *ProjectsLocationsCatalogsBranchesProductsService) Purge(parent string, googlecloudretailv2betapurgeproductsrequest *GoogleCloudRetailV2betaPurgeProductsRequest) *ProjectsLocationsCatalogsBranchesProductsPurgeCall { + c := &ProjectsLocationsCatalogsBranchesProductsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudretailv2betapurgeproductsrequest = googlecloudretailv2betapurgeproductsrequest + 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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsPurgeCall { + 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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsPurgeCall { + 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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsPurgeCall) 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.googlecloudretailv2betapurgeproductsrequest) + 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, "v2beta/{+parent}/products:purge") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", 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 "retail.projects.locations.catalogs.branches.products.purge" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.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 *ProjectsLocationsCatalogsBranchesProductsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, 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 := &GoogleLongrunningOperation{ + 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": "Permanently deletes all selected Products under a branch. This process is asynchronous. If the request is valid, the removal will be enqueued and processed offline. Depending on the number of Products, this operation could take hours to complete. Before the operation completes, some Products may still be returned by ProductService.GetProduct or ProductService.ListProducts. Depending on the number of Products, this operation could take hours to complete. To get a sample of Products that would be deleted, set PurgeProductsRequest.force to false.", + // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:purge", + // "httpMethod": "POST", + // "id": "retail.projects.locations.catalogs.branches.products.purge", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The resource name of the branch under which the products are created. The format is `projects/${projectId}/locations/global/catalogs/${catalogId}/branches/${branchId}`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+parent}/products:purge", + // "request": { + // "$ref": "GoogleCloudRetailV2betaPurgeProductsRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces": type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct { diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json index ddc114a907b..1b6a843882f 100644 --- a/servicemanagement/v1/servicemanagement-api.json +++ b/servicemanagement/v1/servicemanagement-api.json @@ -830,7 +830,7 @@ } } }, - "revision": "20230526", + "revision": "20230609", "rootUrl": "https://servicemanagement.googleapis.com/", "schemas": { "Advice": { @@ -1552,7 +1552,7 @@ "type": "object" }, "Documentation": { - "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", + "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", "properties": { "documentationRootUrl": { @@ -1577,6 +1577,13 @@ }, "type": "array" }, + "sectionOverrides": { + "description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries", + "items": { + "$ref": "Page" + }, + "type": "array" + }, "serviceRootUrl": { "description": "Specifies the service root url if the default one (the service name from the yaml file) is not suitable. This can be seen in any fully specified service urls as well as sections that show a base that other urls are relative to.", "type": "string" diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 6ed1f1041b8..566568fd9ef 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -1605,7 +1605,7 @@ func (s *Diagnostic) MarshalJSON() ([]byte, error) { // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: // Overview content: (== include google/foo/overview.md ==) - name: -// Tutorial content: (== include google/foo/tutorial.md ==) subpages; - +// Tutorial content: (== include google/foo/tutorial.md ==) subpages: - // name: Java content: (== include google/foo/tutorial_java.md ==) // rules: - selector: google.calendar.Calendar.Get description: > ... - // selector: google.calendar.Calendar.Put description: > ... @@ -1651,6 +1651,11 @@ type Documentation struct { // wins" order. Rules []*DocumentationRule `json:"rules,omitempty"` + // SectionOverrides: Specifies section and content to override + // boilerplate content provided by go/api-docgen. Currently overrides + // following sections: 1. rest.service.client_libraries + SectionOverrides []*Page `json:"sectionOverrides,omitempty"` + // ServiceRootUrl: Specifies the service root url if the default one // (the service name from the yaml file) is not suitable. This can be // seen in any fully specified service urls as well as sections that From f06cac5563b71f297a8ee726382fadc106995924 Mon Sep 17 00:00:00 2001 From: "release-please[bot]" <55107282+release-please[bot]@users.noreply.github.com> Date: Thu, 15 Jun 2023 12:11:43 -0700 Subject: [PATCH 4/4] chore(main): release 0.128.0 (#2023) Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> --- CHANGES.md | 9 +++++++++ internal/version.go | 2 +- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/CHANGES.md b/CHANGES.md index e0a5a5e458c..7a047f88524 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,14 @@ # Changes +## [0.128.0](https://github.com/googleapis/google-api-go-client/compare/v0.127.0...v0.128.0) (2023-06-15) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#2022](https://github.com/googleapis/google-api-go-client/issues/2022)) ([d846ea5](https://github.com/googleapis/google-api-go-client/commit/d846ea5dd79c01bbf7f2c116fa40b0bdcdc0dc1a)) +* **all:** Auto-regenerate discovery clients ([#2026](https://github.com/googleapis/google-api-go-client/issues/2026)) ([58512c3](https://github.com/googleapis/google-api-go-client/commit/58512c3c782e9b42d0f215b1f46545686a07033f)) +* **all:** Auto-regenerate discovery clients ([#2027](https://github.com/googleapis/google-api-go-client/issues/2027)) ([229def0](https://github.com/googleapis/google-api-go-client/commit/229def0dc32b86ab6524a4619189aece0b1ebbea)) + ## [0.127.0](https://github.com/googleapis/google-api-go-client/compare/v0.126.0...v0.127.0) (2023-06-12) diff --git a/internal/version.go b/internal/version.go index fb22e076607..54d30ef667a 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.127.0" +const Version = "0.128.0"