From c8d87eba7abbb808d4a079cc2897fecf6faf0abe Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 8 Jun 2022 07:11:39 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- .../v1alpha/analyticsadmin-api.json | 138 +++- analyticsadmin/v1alpha/analyticsadmin-gen.go | 417 +++++++++++ .../v1/androidmanagement-api.json | 224 +++++- androidmanagement/v1/androidmanagement-gen.go | 675 +++++++++++++++++- api-list.json | 2 +- apigee/v1/apigee-api.json | 48 +- apigee/v1/apigee-gen.go | 183 ++--- .../v2/baremetalsolution-api.json | 69 +- baremetalsolution/v2/baremetalsolution-gen.go | 192 ++++- bigquery/v2/bigquery-api.json | 65 +- bigquery/v2/bigquery-gen.go | 117 +++ .../v1/businessprofileperformance-api.json | 8 +- .../v1/businessprofileperformance-gen.go | 12 +- chromemanagement/v1/chromemanagement-api.json | 8 +- chromemanagement/v1/chromemanagement-gen.go | 13 + cloudasset/v1/cloudasset-api.json | 4 +- cloudasset/v1/cloudasset-gen.go | 2 +- cloudchannel/v1/cloudchannel-api.json | 31 +- cloudchannel/v1/cloudchannel-gen.go | 65 +- cloudsearch/v1/cloudsearch-api.json | 154 ++-- cloudsearch/v1/cloudsearch-gen.go | 253 +++---- datafusion/v1beta1/datafusion-api.json | 21 +- datafusion/v1beta1/datafusion-gen.go | 36 + displayvideo/v1/displayvideo-api.json | 5 +- displayvideo/v1/displayvideo-gen.go | 3 +- docs/v1/docs-api.json | 4 +- docs/v1/docs-gen.go | 5 +- documentai/v1/documentai-api.json | 22 +- documentai/v1/documentai-gen.go | 52 +- documentai/v1beta2/documentai-api.json | 14 +- documentai/v1beta2/documentai-gen.go | 32 +- documentai/v1beta3/documentai-api.json | 22 +- documentai/v1beta3/documentai-gen.go | 52 +- file/v1/file-api.json | 10 +- file/v1/file-gen.go | 12 +- gkehub/v1/gkehub-api.json | 77 +- gkehub/v1/gkehub-gen.go | 144 +++- gkehub/v1alpha/gkehub-api.json | 77 +- gkehub/v1alpha/gkehub-gen.go | 144 +++- gkehub/v1beta1/gkehub-api.json | 17 +- gkehub/v1beta1/gkehub-gen.go | 51 +- jobs/v3/jobs-api.json | 20 +- jobs/v3/jobs-gen.go | 15 +- jobs/v3p1beta1/jobs-api.json | 20 +- jobs/v3p1beta1/jobs-gen.go | 15 +- jobs/v4/jobs-api.json | 20 +- jobs/v4/jobs-gen.go | 15 +- .../v1/managedidentities-api.json | 30 +- managedidentities/v1/managedidentities-gen.go | 84 ++- .../v1alpha1/managedidentities-api.json | 90 ++- .../v1alpha1/managedidentities-gen.go | 272 ++++++- .../v1/paymentsresellersubscription-api.json | 11 +- .../v1/paymentsresellersubscription-gen.go | 35 +- securitycenter/v1/securitycenter-api.json | 28 +- securitycenter/v1/securitycenter-gen.go | 32 +- .../v1beta1/securitycenter-api.json | 28 +- securitycenter/v1beta1/securitycenter-gen.go | 32 +- .../v1beta2/securitycenter-api.json | 28 +- securitycenter/v1beta2/securitycenter-gen.go | 32 +- 59 files changed, 3520 insertions(+), 767 deletions(-) diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index 04639a93298..c533b2c4dd6 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -739,6 +739,32 @@ "https://www.googleapis.com/auth/analytics.readonly" ] }, + "getAttributionSettings": { + "description": "Lookup for a AttributionSettings singleton.", + "flatPath": "v1alpha/properties/{propertiesId}/attributionSettings", + "httpMethod": "GET", + "id": "analyticsadmin.properties.getAttributionSettings", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the attribution settings to retrieve. Format: properties/{property}/attributionSettings", + "location": "path", + "pattern": "^properties/[^/]+/attributionSettings$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit", + "https://www.googleapis.com/auth/analytics.readonly" + ] + }, "getDataRetentionSettings": { "description": "Returns the singleton data retention settings for this property.", "flatPath": "v1alpha/properties/{propertiesId}/dataRetentionSettings", @@ -863,6 +889,40 @@ "https://www.googleapis.com/auth/analytics.edit" ] }, + "updateAttributionSettings": { + "description": "Updates attribution settings on a property.", + "flatPath": "v1alpha/properties/{propertiesId}/attributionSettings", + "httpMethod": "PATCH", + "id": "analyticsadmin.properties.updateAttributionSettings", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of this attribution settings resource. Format: properties/{property_id}/attributionSettings Example: \"properties/1000/attributionSettings\"", + "location": "path", + "pattern": "^properties/[^/]+/attributionSettings$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. The list of fields to be updated. Field names must be in snake case (e.g., \"field_to_update\"). Omitted fields will not be updated. To replace the entire entity, use one path with the string \"*\" to match all fields.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings" + }, + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + }, "updateDataRetentionSettings": { "description": "Updates the singleton data retention settings for this property.", "flatPath": "v1alpha/properties/{propertiesId}/dataRetentionSettings", @@ -2556,7 +2616,7 @@ } } }, - "revision": "20220322", + "revision": "20220606", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccount": { @@ -2668,6 +2728,72 @@ "properties": {}, "type": "object" }, + "GoogleAnalyticsAdminV1alphaAttributionSettings": { + "description": "The attribution settings used for a given property. This is a singleton resource.", + "id": "GoogleAnalyticsAdminV1alphaAttributionSettings", + "properties": { + "acquisitionConversionEventLookbackWindow": { + "description": "Required. The lookback window configuration for acquisition conversion events. The default window size is 30 days.", + "enum": [ + "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_UNSPECIFIED", + "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_7_DAYS", + "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS" + ], + "enumDescriptions": [ + "Lookback window size unspecified.", + "7-day lookback window.", + "30-day lookback window." + ], + "type": "string" + }, + "name": { + "description": "Output only. Resource name of this attribution settings resource. Format: properties/{property_id}/attributionSettings Example: \"properties/1000/attributionSettings\"", + "readOnly": true, + "type": "string" + }, + "otherConversionEventLookbackWindow": { + "description": "Required. The lookback window for all other, non-acquisition conversion events. The default window size is 90 days.", + "enum": [ + "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_UNSPECIFIED", + "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS", + "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_60_DAYS", + "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS" + ], + "enumDescriptions": [ + "Lookback window size unspecified.", + "30-day lookback window.", + "60-day lookback window.", + "90-day lookback window." + ], + "type": "string" + }, + "reportingAttributionModel": { + "description": "Required. The reporting attribution model used to calculate conversion credit in this property's reports. Changing the attribution model will apply to both historical and future data. These changes will be reflected in reports with conversion and revenue data. User and session data will be unaffected.", + "enum": [ + "REPORTING_ATTRIBUTION_MODEL_UNSPECIFIED", + "CROSS_CHANNEL_DATA_DRIVEN", + "CROSS_CHANNEL_LAST_CLICK", + "CROSS_CHANNEL_FIRST_CLICK", + "CROSS_CHANNEL_LINEAR", + "CROSS_CHANNEL_POSITION_BASED", + "CROSS_CHANNEL_TIME_DECAY", + "ADS_PREFERRED_LAST_CLICK" + ], + "enumDescriptions": [ + "Reporting attribution model unspecified.", + "Data-driven attribution distributes credit for the conversion based on data for each conversion event. Each Data-driven model is specific to each advertiser and each conversion event.", + "Ignores direct traffic and attributes 100% of the conversion value to the last channel that the customer clicked through (or engaged view through for YouTube) before converting.", + "Gives all credit for the conversion to the first channel that a customer clicked (or engaged view through for YouTube) before converting.", + "Distributes the credit for the conversion equally across all the channels a customer clicked (or engaged view through for YouTube) before converting.", + "Attributes 40% credit to the first and last interaction, and the remaining 20% credit is distributed evenly to the middle interactions.", + "Gives more credit to the touchpoints that happened closer in time to the conversion.", + "Attributes 100% of the conversion value to the last Google Ads channel that the customer clicked through before converting." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleAnalyticsAdminV1alphaAuditUserLink": { "description": "Read-only resource used to summarize a principal's effective roles.", "id": "GoogleAnalyticsAdminV1alphaAuditUserLink", @@ -2868,6 +2994,10 @@ "$ref": "GoogleAnalyticsAdminV1alphaAccount", "description": "A snapshot of an Account resource in change history." }, + "attributionSettings": { + "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings", + "description": "A snapshot of AttributionSettings resource in change history." + }, "conversionEvent": { "$ref": "GoogleAnalyticsAdminV1alphaConversionEvent", "description": "A snapshot of a ConversionEvent resource in change history." @@ -4111,7 +4241,8 @@ "DATA_RETENTION_SETTINGS", "DISPLAY_VIDEO_360_ADVERTISER_LINK", "DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL", - "DATA_STREAM" + "DATA_STREAM", + "ATTRIBUTION_SETTINGS" ], "enumDescriptions": [ "Resource type unknown or not specified.", @@ -4127,7 +4258,8 @@ "DataRetentionSettings resource", "DisplayVideo360AdvertiserLink resource", "DisplayVideo360AdvertiserLinkProposal resource", - "DataStream resource" + "DataStream resource", + "AttributionSettings resource" ], "type": "string" }, diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index fcf0b6b3f57..31f16015c18 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -510,6 +510,105 @@ type GoogleAnalyticsAdminV1alphaArchiveCustomDimensionRequest struct { type GoogleAnalyticsAdminV1alphaArchiveCustomMetricRequest struct { } +// GoogleAnalyticsAdminV1alphaAttributionSettings: The attribution +// settings used for a given property. This is a singleton resource. +type GoogleAnalyticsAdminV1alphaAttributionSettings struct { + // AcquisitionConversionEventLookbackWindow: Required. The lookback + // window configuration for acquisition conversion events. The default + // window size is 30 days. + // + // Possible values: + // "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_UNSPECIFIED" - + // Lookback window size unspecified. + // "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_7_DAYS" - 7-day + // lookback window. + // "ACQUISITION_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS" - 30-day + // lookback window. + AcquisitionConversionEventLookbackWindow string `json:"acquisitionConversionEventLookbackWindow,omitempty"` + + // Name: Output only. Resource name of this attribution settings + // resource. Format: properties/{property_id}/attributionSettings + // Example: "properties/1000/attributionSettings" + Name string `json:"name,omitempty"` + + // OtherConversionEventLookbackWindow: Required. The lookback window for + // all other, non-acquisition conversion events. The default window size + // is 90 days. + // + // Possible values: + // "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_UNSPECIFIED" - Lookback + // window size unspecified. + // "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_30_DAYS" - 30-day lookback + // window. + // "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_60_DAYS" - 60-day lookback + // window. + // "OTHER_CONVERSION_EVENT_LOOKBACK_WINDOW_90_DAYS" - 90-day lookback + // window. + OtherConversionEventLookbackWindow string `json:"otherConversionEventLookbackWindow,omitempty"` + + // ReportingAttributionModel: Required. The reporting attribution model + // used to calculate conversion credit in this property's reports. + // Changing the attribution model will apply to both historical and + // future data. These changes will be reflected in reports with + // conversion and revenue data. User and session data will be + // unaffected. + // + // Possible values: + // "REPORTING_ATTRIBUTION_MODEL_UNSPECIFIED" - Reporting attribution + // model unspecified. + // "CROSS_CHANNEL_DATA_DRIVEN" - Data-driven attribution distributes + // credit for the conversion based on data for each conversion event. + // Each Data-driven model is specific to each advertiser and each + // conversion event. + // "CROSS_CHANNEL_LAST_CLICK" - Ignores direct traffic and attributes + // 100% of the conversion value to the last channel that the customer + // clicked through (or engaged view through for YouTube) before + // converting. + // "CROSS_CHANNEL_FIRST_CLICK" - Gives all credit for the conversion + // to the first channel that a customer clicked (or engaged view through + // for YouTube) before converting. + // "CROSS_CHANNEL_LINEAR" - Distributes the credit for the conversion + // equally across all the channels a customer clicked (or engaged view + // through for YouTube) before converting. + // "CROSS_CHANNEL_POSITION_BASED" - Attributes 40% credit to the first + // and last interaction, and the remaining 20% credit is distributed + // evenly to the middle interactions. + // "CROSS_CHANNEL_TIME_DECAY" - Gives more credit to the touchpoints + // that happened closer in time to the conversion. + // "ADS_PREFERRED_LAST_CLICK" - Attributes 100% of the conversion + // value to the last Google Ads channel that the customer clicked + // through before converting. + ReportingAttributionModel string `json:"reportingAttributionModel,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. + // "AcquisitionConversionEventLookbackWindow") 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. + // "AcquisitionConversionEventLookbackWindow") 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 *GoogleAnalyticsAdminV1alphaAttributionSettings) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaAttributionSettings + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaAuditUserLink: Read-only resource used to // summarize a principal's effective roles. type GoogleAnalyticsAdminV1alphaAuditUserLink struct { @@ -888,6 +987,10 @@ type GoogleAnalyticsAdminV1alphaChangeHistoryChangeChangeHistoryResource struct // Account: A snapshot of an Account resource in change history. Account *GoogleAnalyticsAdminV1alphaAccount `json:"account,omitempty"` + // AttributionSettings: A snapshot of AttributionSettings resource in + // change history. + AttributionSettings *GoogleAnalyticsAdminV1alphaAttributionSettings `json:"attributionSettings,omitempty"` + // ConversionEvent: A snapshot of a ConversionEvent resource in change // history. ConversionEvent *GoogleAnalyticsAdminV1alphaConversionEvent `json:"conversionEvent,omitempty"` @@ -2883,6 +2986,7 @@ type GoogleAnalyticsAdminV1alphaSearchChangeHistoryEventsRequest struct { // "DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL" - // DisplayVideo360AdvertiserLinkProposal resource // "DATA_STREAM" - DataStream resource + // "ATTRIBUTION_SETTINGS" - AttributionSettings resource ResourceType []string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -6447,6 +6551,156 @@ func (c *PropertiesGetCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAd } +// method id "analyticsadmin.properties.getAttributionSettings": + +type PropertiesGetAttributionSettingsCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAttributionSettings: Lookup for a AttributionSettings singleton. +// +// - name: The name of the attribution settings to retrieve. Format: +// properties/{property}/attributionSettings. +func (r *PropertiesService) GetAttributionSettings(name string) *PropertiesGetAttributionSettingsCall { + c := &PropertiesGetAttributionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *PropertiesGetAttributionSettingsCall) Fields(s ...googleapi.Field) *PropertiesGetAttributionSettingsCall { + 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 *PropertiesGetAttributionSettingsCall) IfNoneMatch(entityTag string) *PropertiesGetAttributionSettingsCall { + 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 *PropertiesGetAttributionSettingsCall) Context(ctx context.Context) *PropertiesGetAttributionSettingsCall { + 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 *PropertiesGetAttributionSettingsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesGetAttributionSettingsCall) 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, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.getAttributionSettings" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaAttributionSettings or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaAttributionSettings.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 *PropertiesGetAttributionSettingsCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaAttributionSettings, 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, &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, err + } + ret := &GoogleAnalyticsAdminV1alphaAttributionSettings{ + 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": "Lookup for a AttributionSettings singleton.", + // "flatPath": "v1alpha/properties/{propertiesId}/attributionSettings", + // "httpMethod": "GET", + // "id": "analyticsadmin.properties.getAttributionSettings", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the attribution settings to retrieve. Format: properties/{property}/attributionSettings", + // "location": "path", + // "pattern": "^properties/[^/]+/attributionSettings$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit", + // "https://www.googleapis.com/auth/analytics.readonly" + // ] + // } + +} + // method id "analyticsadmin.properties.getDataRetentionSettings": type PropertiesGetDataRetentionSettingsCall struct { @@ -7137,6 +7391,169 @@ func (c *PropertiesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleAnalytics } +// method id "analyticsadmin.properties.updateAttributionSettings": + +type PropertiesUpdateAttributionSettingsCall struct { + s *Service + name string + googleanalyticsadminv1alphaattributionsettings *GoogleAnalyticsAdminV1alphaAttributionSettings + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateAttributionSettings: Updates attribution settings on a +// property. +// +// - name: Output only. Resource name of this attribution settings +// resource. Format: properties/{property_id}/attributionSettings +// Example: "properties/1000/attributionSettings". +func (r *PropertiesService) UpdateAttributionSettings(name string, googleanalyticsadminv1alphaattributionsettings *GoogleAnalyticsAdminV1alphaAttributionSettings) *PropertiesUpdateAttributionSettingsCall { + c := &PropertiesUpdateAttributionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleanalyticsadminv1alphaattributionsettings = googleanalyticsadminv1alphaattributionsettings + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to be updated. Field names must be in snake case +// (e.g., "field_to_update"). Omitted fields will not be updated. To +// replace the entire entity, use one path with the string "*" to match +// all fields. +func (c *PropertiesUpdateAttributionSettingsCall) UpdateMask(updateMask string) *PropertiesUpdateAttributionSettingsCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *PropertiesUpdateAttributionSettingsCall) Fields(s ...googleapi.Field) *PropertiesUpdateAttributionSettingsCall { + 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 *PropertiesUpdateAttributionSettingsCall) Context(ctx context.Context) *PropertiesUpdateAttributionSettingsCall { + 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 *PropertiesUpdateAttributionSettingsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesUpdateAttributionSettingsCall) 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.googleanalyticsadminv1alphaattributionsettings) + 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, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.updateAttributionSettings" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaAttributionSettings or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaAttributionSettings.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 *PropertiesUpdateAttributionSettingsCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaAttributionSettings, 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, &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, err + } + ret := &GoogleAnalyticsAdminV1alphaAttributionSettings{ + 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 attribution settings on a property.", + // "flatPath": "v1alpha/properties/{propertiesId}/attributionSettings", + // "httpMethod": "PATCH", + // "id": "analyticsadmin.properties.updateAttributionSettings", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. Resource name of this attribution settings resource. Format: properties/{property_id}/attributionSettings Example: \"properties/1000/attributionSettings\"", + // "location": "path", + // "pattern": "^properties/[^/]+/attributionSettings$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. The list of fields to be updated. Field names must be in snake case (e.g., \"field_to_update\"). Omitted fields will not be updated. To replace the entire entity, use one path with the string \"*\" to match all fields.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "request": { + // "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings" + // }, + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + // method id "analyticsadmin.properties.updateDataRetentionSettings": type PropertiesUpdateDataRetentionSettingsCall struct { diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 497aa5138d4..a1893bcce62 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -609,7 +609,7 @@ "enrollmentTokens": { "methods": { "create": { - "description": "Creates an enrollment token for a given enterprise.", + "description": "Creates an enrollment token for a given enterprise. It's up to the caller's responsibility to manage the lifecycle of newly created tokens and deleting them when they're not intended to be used anymore. Once an enrollment token has been created, it's not possible to retrieve the token's content anymore using AM API. It is recommended for EMMs to securely store the token if it's intended to be reused.", "flatPath": "v1/enterprises/{enterprisesId}/enrollmentTokens", "httpMethod": "POST", "id": "androidmanagement.enterprises.enrollmentTokens.create", @@ -660,6 +660,67 @@ "scopes": [ "https://www.googleapis.com/auth/androidmanagement" ] + }, + "get": { + "description": "Gets an active, unexpired enrollment token. Only a partial view of EnrollmentToken is returned: all the fields but name and expiration_timestamp are empty. This method is meant to help manage active enrollment tokens lifecycle. For security reasons, it's recommended to delete active enrollment tokens as soon as they're not intended to be used anymore.", + "flatPath": "v1/enterprises/{enterprisesId}/enrollmentTokens/{enrollmentTokensId}", + "httpMethod": "GET", + "id": "androidmanagement.enterprises.enrollmentTokens.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the enrollment token in the form enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.", + "location": "path", + "pattern": "^enterprises/[^/]+/enrollmentTokens/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "EnrollmentToken" + }, + "scopes": [ + "https://www.googleapis.com/auth/androidmanagement" + ] + }, + "list": { + "description": "Lists active, unexpired enrollment tokens for a given enterprise. The list items contain only a partial view of EnrollmentToken: all the fields but name and expiration_timestamp are empty. This method is meant to help manage active enrollment tokens lifecycle. For security reasons, it's recommended to delete active enrollment tokens as soon as they're not intended to be used anymore.", + "flatPath": "v1/enterprises/{enterprisesId}/enrollmentTokens", + "httpMethod": "GET", + "id": "androidmanagement.enterprises.enrollmentTokens.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "The requested page size. The service may return fewer than this value. If unspecified, at most 10 items will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results returned by the server.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The name of the enterprise in the form enterprises/{enterpriseId}.", + "location": "path", + "pattern": "^enterprises/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/enrollmentTokens", + "response": { + "$ref": "ListEnrollmentTokensResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/androidmanagement" + ] } } }, @@ -1004,7 +1065,7 @@ } } }, - "revision": "20220524", + "revision": "20220601", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdvancedSecurityOverrides": { @@ -1675,10 +1736,47 @@ }, "type": "object" }, + "ClearAppsDataParams": { + "description": "Parameters associated with the CLEAR_APP_DATA command to clear the data of specified apps from the device.", + "id": "ClearAppsDataParams", + "properties": { + "packageNames": { + "description": "The package names of the apps whose data will be cleared when the command is executed.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ClearAppsDataStatus": { + "description": "Status of the CLEAR_APP_DATA command to clear the data of specified apps from the device.", + "id": "ClearAppsDataStatus", + "properties": { + "results": { + "additionalProperties": { + "$ref": "PerAppResult" + }, + "description": "The per-app results, a mapping from package names to the respective clearing result.", + "type": "object" + } + }, + "type": "object" + }, "Command": { "description": "A command.", "id": "Command", "properties": { + "clearAppsDataParams": { + "$ref": "ClearAppsDataParams", + "description": "Parameters for the CLEAR_APP_DATA command to clear the data of specified apps from the device. See ClearAppsDataParams. If this is set, then it is suggested that type should not be set. In this case, the server automatically sets it to CLEAR_APP_DATA. It is also acceptable to explicitly set type to CLEAR_APP_DATA." + }, + "clearAppsDataStatus": { + "$ref": "ClearAppsDataStatus", + "description": "Output only. Status of the CLEAR_APP_DATA command to clear the data of specified apps from the device. See ClearAppsDataStatus.", + "readOnly": true + }, "createTime": { "description": "The timestamp at which the command was created. The timestamp is automatically generated by the server.", "format": "google-datetime", @@ -1739,14 +1837,16 @@ "LOCK", "RESET_PASSWORD", "REBOOT", - "RELINQUISH_OWNERSHIP" + "RELINQUISH_OWNERSHIP", + "CLEAR_APP_DATA" ], "enumDescriptions": [ "This value is disallowed.", "Lock the device, as if the lock screen timeout had expired.", "Reset the user's password.", "Reboot the device. Only supported on fully managed devices running Android 7.0 (API level 24) or higher.", - "Removes the work profile and all policies from a company-owned Android 8.0+ device, relinquishing the device for personal use. Apps and data associated with the personal profile(s) are preserved. The device will be deleted from the server after it acknowledges the command." + "Removes the work profile and all policies from a company-owned Android 8.0+ device, relinquishing the device for personal use. Apps and data associated with the personal profile(s) are preserved. The device will be deleted from the server after it acknowledges the command.", + "Clears the application data of specified apps. This is supported on Android 9 and above. Note that an application can store data outside of its application data, for example in external storage or in a user dictionary. See also clear_apps_data_params." ], "type": "string" }, @@ -2774,6 +2874,24 @@ }, "type": "object" }, + "ListEnrollmentTokensResponse": { + "description": "Response to a request to list enrollment tokens for a given enterprise.", + "id": "ListEnrollmentTokensResponse", + "properties": { + "enrollmentTokens": { + "description": "The list of enrollment tokens.", + "items": { + "$ref": "EnrollmentToken" + }, + "type": "array" + }, + "nextPageToken": { + "description": "If there are more results, a token to retrieve next page of results.", + "type": "string" + } + }, + "type": "object" + }, "ListEnterprisesResponse": { "description": "Response to a request to list enterprises.", "id": "ListEnterprisesResponse", @@ -3105,6 +3223,28 @@ "settingName": { "description": "The name of the policy setting. This is the JSON field name of a top-level Policy field.", "type": "string" + }, + "specificNonComplianceContext": { + "$ref": "SpecificNonComplianceContext", + "description": "Additional context for specific_non_compliance_reason." + }, + "specificNonComplianceReason": { + "description": "The policy-specific reason the device is not in compliance with the setting.", + "enum": [ + "SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED", + "PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED", + "PASSWORD_POLICIES_PASSWORD_EXPIRED", + "PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT", + "ONC_WIFI_INVALID_VALUE" + ], + "enumDescriptions": [ + "Specific non-compliance reason is not specified. Fields in specific_non_compliance_context are not set.", + "User needs to confirm credentials by entering the screen lock. Fields in specific_non_compliance_context are not set. nonComplianceReason is set to USER_ACTION.", + "The device or profile password has expired. passwordPoliciesContext is set. nonComplianceReason is set to USER_ACTION.", + "The device password does not satisfy password requirements. passwordPoliciesContext is set. nonComplianceReason is set to USER_ACTION.", + "There is an incorrect value in ONC Wi-Fi configuration. fieldPath specifies which field value is incorrect. oncWifiContext is set. nonComplianceReason is set to INVALID_VALUE." + ], + "type": "string" } }, "type": "object" @@ -3172,6 +3312,17 @@ }, "type": "object" }, + "OncWifiContext": { + "description": "Additional context for non-compliance related to Wi-Fi configuration.", + "id": "OncWifiContext", + "properties": { + "wifiGuid": { + "description": "The GUID of non-compliant Wi-Fi configuration.", + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -3221,6 +3372,27 @@ }, "type": "object" }, + "PasswordPoliciesContext": { + "description": "Additional context for non-compliance related to password policies.", + "id": "PasswordPoliciesContext", + "properties": { + "passwordPolicyScope": { + "description": "The scope of non-compliant password.", + "enum": [ + "SCOPE_UNSPECIFIED", + "SCOPE_DEVICE", + "SCOPE_PROFILE" + ], + "enumDescriptions": [ + "The scope is unspecified. The password requirements are applied to the work profile for work profile devices and the whole device for fully managed or dedicated devices.", + "The password requirements are only applied to the device.", + "The password requirements are only applied to the work profile." + ], + "type": "string" + } + }, + "type": "object" + }, "PasswordRequirements": { "description": "Requirements for the password used to unlock a device.", "id": "PasswordRequirements", @@ -3350,6 +3522,31 @@ }, "type": "object" }, + "PerAppResult": { + "description": "The result of an attempt to clear the data of a single app.", + "id": "PerAppResult", + "properties": { + "clearingResult": { + "description": "The result of an attempt to clear the data of a single app.", + "enum": [ + "CLEARING_RESULT_UNSPECIFIED", + "SUCCESS", + "APP_NOT_FOUND", + "APP_PROTECTED", + "API_LEVEL" + ], + "enumDescriptions": [ + "Unspecified result.", + "This app’s data was successfully cleared.", + "This app’s data could not be cleared because the app was not found.", + "This app’s data could not be cleared because the app is protected. For example, this may apply to apps critical to the functioning of the device, such as Google Play Store.", + "This app’s data could not be cleared because the device API level does not support this command." + ], + "type": "string" + } + }, + "type": "object" + }, "PermissionGrant": { "description": "Configuration for an Android permission and its grant state.", "id": "PermissionGrant", @@ -4310,6 +4507,21 @@ }, "type": "object" }, + "SpecificNonComplianceContext": { + "description": "Additional context for SpecificNonComplianceReason.", + "id": "SpecificNonComplianceContext", + "properties": { + "oncWifiContext": { + "$ref": "OncWifiContext", + "description": "Additional context for non-compliance related to Wi-Fi configuration. See ONC_WIFI_INVALID_VALUE." + }, + "passwordPoliciesContext": { + "$ref": "PasswordPoliciesContext", + "description": "Additional context for non-compliance related to password policies. See PASSWORD_POLICIES_PASSWORD_EXPIRED and PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT." + } + }, + "type": "object" + }, "Status": { "description": "The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -4502,7 +4714,7 @@ ], "enumDescriptions": [ "This value is not used.", - "Enable logging of on-device security events, like when the device password is incorrectly entered or removable storage is mounted. See event for a complete description of the logged security events. Supported for fully managed devices on Android 7.0 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only security events from the work profile are logged.", + "Enable logging of on-device security events, like when the device password is incorrectly entered or removable storage is mounted. See event for a complete description of the logged security events. Supported for fully managed devices on Android 7 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only security events from the work profile are logged.", "Enable logging of on-device network events, like DNS lookups and TCP connections. See event for a complete description of the logged network events. Supported for fully managed devices on Android 8 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only network events from the work profile are logged." ], "type": "string" @@ -4519,7 +4731,7 @@ ], "enumDescriptions": [ "This value is not used.", - "Enable logging of on-device security events, like when the device password is incorrectly entered or removable storage is mounted. See event for a complete description of the logged security events. Supported for fully managed devices on Android 7.0 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only security events from the work profile are logged.", + "Enable logging of on-device security events, like when the device password is incorrectly entered or removable storage is mounted. See event for a complete description of the logged security events. Supported for fully managed devices on Android 7 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only security events from the work profile are logged.", "Enable logging of on-device network events, like DNS lookups and TCP connections. See event for a complete description of the logged network events. Supported for fully managed devices on Android 8 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only network events from the work profile are logged." ], "type": "string" diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index f4d9a139d14..cf8a8837296 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -1104,8 +1104,81 @@ func (s *ChoosePrivateKeyRule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ClearAppsDataParams: Parameters associated with the CLEAR_APP_DATA +// command to clear the data of specified apps from the device. +type ClearAppsDataParams struct { + // PackageNames: The package names of the apps whose data will be + // cleared when the command is executed. + PackageNames []string `json:"packageNames,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PackageNames") 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. "PackageNames") 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 *ClearAppsDataParams) MarshalJSON() ([]byte, error) { + type NoMethod ClearAppsDataParams + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ClearAppsDataStatus: Status of the CLEAR_APP_DATA command to clear +// the data of specified apps from the device. +type ClearAppsDataStatus struct { + // Results: The per-app results, a mapping from package names to the + // respective clearing result. + Results map[string]PerAppResult `json:"results,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Results") 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. "Results") 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 *ClearAppsDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod ClearAppsDataStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Command: A command. type Command struct { + // ClearAppsDataParams: Parameters for the CLEAR_APP_DATA command to + // clear the data of specified apps from the device. See + // ClearAppsDataParams. If this is set, then it is suggested that type + // should not be set. In this case, the server automatically sets it to + // CLEAR_APP_DATA. It is also acceptable to explicitly set type to + // CLEAR_APP_DATA. + ClearAppsDataParams *ClearAppsDataParams `json:"clearAppsDataParams,omitempty"` + + // ClearAppsDataStatus: Output only. Status of the CLEAR_APP_DATA + // command to clear the data of specified apps from the device. See + // ClearAppsDataStatus. + ClearAppsDataStatus *ClearAppsDataStatus `json:"clearAppsDataStatus,omitempty"` + // CreateTime: The timestamp at which the command was created. The // timestamp is automatically generated by the server. CreateTime string `json:"createTime,omitempty"` @@ -1161,6 +1234,11 @@ type Command struct { // for personal use. Apps and data associated with the personal // profile(s) are preserved. The device will be deleted from the server // after it acknowledges the command. + // "CLEAR_APP_DATA" - Clears the application data of specified apps. + // This is supported on Android 9 and above. Note that an application + // can store data outside of its application data, for example in + // external storage or in a user dictionary. See also + // clear_apps_data_params. Type string `json:"type,omitempty"` // UserName: The resource name of the user that owns the device in the @@ -1168,20 +1246,21 @@ type Command struct { // generated by the server based on the device the command is sent to. UserName string `json:"userName,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "ClearAppsDataParams") + // 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 is a list of field names (e.g. "ClearAppsDataParams") 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:"-"` } @@ -2534,6 +2613,44 @@ func (s *ListDevicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListEnrollmentTokensResponse: Response to a request to list +// enrollment tokens for a given enterprise. +type ListEnrollmentTokensResponse struct { + // EnrollmentTokens: The list of enrollment tokens. + EnrollmentTokens []*EnrollmentToken `json:"enrollmentTokens,omitempty"` + + // NextPageToken: If there are more results, a token to retrieve next + // page of results. + 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. "EnrollmentTokens") 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. "EnrollmentTokens") 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 *ListEnrollmentTokensResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListEnrollmentTokensResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListEnterprisesResponse: Response to a request to list enterprises. type ListEnterprisesResponse struct { // Enterprises: The list of enterprises. @@ -3021,6 +3138,32 @@ type NonComplianceDetail struct { // name of a top-level Policy field. SettingName string `json:"settingName,omitempty"` + // SpecificNonComplianceContext: Additional context for + // specific_non_compliance_reason. + SpecificNonComplianceContext *SpecificNonComplianceContext `json:"specificNonComplianceContext,omitempty"` + + // SpecificNonComplianceReason: The policy-specific reason the device is + // not in compliance with the setting. + // + // Possible values: + // "SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED" - Specific + // non-compliance reason is not specified. Fields in + // specific_non_compliance_context are not set. + // "PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED" - User + // needs to confirm credentials by entering the screen lock. Fields in + // specific_non_compliance_context are not set. nonComplianceReason is + // set to USER_ACTION. + // "PASSWORD_POLICIES_PASSWORD_EXPIRED" - The device or profile + // password has expired. passwordPoliciesContext is set. + // nonComplianceReason is set to USER_ACTION. + // "PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT" - The device password + // does not satisfy password requirements. passwordPoliciesContext is + // set. nonComplianceReason is set to USER_ACTION. + // "ONC_WIFI_INVALID_VALUE" - There is an incorrect value in ONC Wi-Fi + // configuration. fieldPath specifies which field value is incorrect. + // oncWifiContext is set. nonComplianceReason is set to INVALID_VALUE. + SpecificNonComplianceReason string `json:"specificNonComplianceReason,omitempty"` + // ForceSendFields is a list of field names (e.g. "CurrentValue") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -3143,6 +3286,35 @@ func (s *OncCertificateProvider) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// OncWifiContext: Additional context for non-compliance related to +// Wi-Fi configuration. +type OncWifiContext struct { + // WifiGuid: The GUID of non-compliant Wi-Fi configuration. + WifiGuid string `json:"wifiGuid,omitempty"` + + // ForceSendFields is a list of field names (e.g. "WifiGuid") 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. "WifiGuid") 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 *OncWifiContext) MarshalJSON() ([]byte, error) { + type NoMethod OncWifiContext + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -3232,6 +3404,45 @@ func (s *PackageNameList) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// PasswordPoliciesContext: Additional context for non-compliance +// related to password policies. +type PasswordPoliciesContext struct { + // PasswordPolicyScope: The scope of non-compliant password. + // + // Possible values: + // "SCOPE_UNSPECIFIED" - The scope is unspecified. The password + // requirements are applied to the work profile for work profile devices + // and the whole device for fully managed or dedicated devices. + // "SCOPE_DEVICE" - The password requirements are only applied to the + // device. + // "SCOPE_PROFILE" - The password requirements are only applied to the + // work profile. + PasswordPolicyScope string `json:"passwordPolicyScope,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PasswordPolicyScope") + // 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. "PasswordPolicyScope") 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 *PasswordPoliciesContext) MarshalJSON() ([]byte, error) { + type NoMethod PasswordPoliciesContext + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // PasswordRequirements: Requirements for the password used to unlock a // device. type PasswordRequirements struct { @@ -3417,6 +3628,48 @@ func (s *PasswordRequirements) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// PerAppResult: The result of an attempt to clear the data of a single +// app. +type PerAppResult struct { + // ClearingResult: The result of an attempt to clear the data of a + // single app. + // + // Possible values: + // "CLEARING_RESULT_UNSPECIFIED" - Unspecified result. + // "SUCCESS" - This app’s data was successfully cleared. + // "APP_NOT_FOUND" - This app’s data could not be cleared because + // the app was not found. + // "APP_PROTECTED" - This app’s data could not be cleared because + // the app is protected. For example, this may apply to apps critical to + // the functioning of the device, such as Google Play Store. + // "API_LEVEL" - This app’s data could not be cleared because the + // device API level does not support this command. + ClearingResult string `json:"clearingResult,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClearingResult") 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. "ClearingResult") 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 *PerAppResult) MarshalJSON() ([]byte, error) { + type NoMethod PerAppResult + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // PermissionGrant: Configuration for an Android permission and its // grant state. type PermissionGrant struct { @@ -4620,6 +4873,42 @@ func (s *SoftwareInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SpecificNonComplianceContext: Additional context for +// SpecificNonComplianceReason. +type SpecificNonComplianceContext struct { + // OncWifiContext: Additional context for non-compliance related to + // Wi-Fi configuration. See ONC_WIFI_INVALID_VALUE. + OncWifiContext *OncWifiContext `json:"oncWifiContext,omitempty"` + + // PasswordPoliciesContext: Additional context for non-compliance + // related to password policies. See PASSWORD_POLICIES_PASSWORD_EXPIRED + // and PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT. + PasswordPoliciesContext *PasswordPoliciesContext `json:"passwordPoliciesContext,omitempty"` + + // ForceSendFields is a list of field names (e.g. "OncWifiContext") 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. "OncWifiContext") 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 *SpecificNonComplianceContext) MarshalJSON() ([]byte, error) { + type NoMethod SpecificNonComplianceContext + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Status: The Status type defines a logical error model that is // suitable for different programming environments, including REST APIs // and RPC APIs. It is used by gRPC (https://github.com/grpc). Each @@ -4928,8 +5217,8 @@ type UsageLog struct { // "SECURITY_LOGS" - Enable logging of on-device security events, like // when the device password is incorrectly entered or removable storage // is mounted. See event for a complete description of the logged - // security events. Supported for fully managed devices on Android 7.0 - // and above. Supported for company-owned devices with a work profile on + // security events. Supported for fully managed devices on Android 7 and + // above. Supported for company-owned devices with a work profile on // Android 12 and above, on which only security events from the work // profile are logged. // "NETWORK_ACTIVITY_LOGS" - Enable logging of on-device network @@ -4949,8 +5238,8 @@ type UsageLog struct { // "SECURITY_LOGS" - Enable logging of on-device security events, like // when the device password is incorrectly entered or removable storage // is mounted. See event for a complete description of the logged - // security events. Supported for fully managed devices on Android 7.0 - // and above. Supported for company-owned devices with a work profile on + // security events. Supported for fully managed devices on Android 7 and + // above. Supported for company-owned devices with a work profile on // Android 12 and above, on which only security events from the work // profile are logged. // "NETWORK_ACTIVITY_LOGS" - Enable logging of on-device network @@ -7736,7 +8025,13 @@ type EnterprisesEnrollmentTokensCreateCall struct { header_ http.Header } -// Create: Creates an enrollment token for a given enterprise. +// Create: Creates an enrollment token for a given enterprise. It's up +// to the caller's responsibility to manage the lifecycle of newly +// created tokens and deleting them when they're not intended to be used +// anymore. Once an enrollment token has been created, it's not possible +// to retrieve the token's content anymore using AM API. It is +// recommended for EMMs to securely store the token if it's intended to +// be reused. // // - parent: The name of the enterprise in the form // enterprises/{enterpriseId}. @@ -7838,7 +8133,7 @@ func (c *EnterprisesEnrollmentTokensCreateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Creates an enrollment token for a given enterprise.", + // "description": "Creates an enrollment token for a given enterprise. It's up to the caller's responsibility to manage the lifecycle of newly created tokens and deleting them when they're not intended to be used anymore. Once an enrollment token has been created, it's not possible to retrieve the token's content anymore using AM API. It is recommended for EMMs to securely store the token if it's intended to be reused.", // "flatPath": "v1/enterprises/{enterprisesId}/enrollmentTokens", // "httpMethod": "POST", // "id": "androidmanagement.enterprises.enrollmentTokens.create", @@ -8002,6 +8297,358 @@ func (c *EnterprisesEnrollmentTokensDeleteCall) Do(opts ...googleapi.CallOption) } +// method id "androidmanagement.enterprises.enrollmentTokens.get": + +type EnterprisesEnrollmentTokensGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets an active, unexpired enrollment token. Only a partial view +// of EnrollmentToken is returned: all the fields but name and +// expiration_timestamp are empty. This method is meant to help manage +// active enrollment tokens lifecycle. For security reasons, it's +// recommended to delete active enrollment tokens as soon as they're not +// intended to be used anymore. +// +// - name: The name of the enrollment token in the form +// enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}. +func (r *EnterprisesEnrollmentTokensService) Get(name string) *EnterprisesEnrollmentTokensGetCall { + c := &EnterprisesEnrollmentTokensGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *EnterprisesEnrollmentTokensGetCall) Fields(s ...googleapi.Field) *EnterprisesEnrollmentTokensGetCall { + 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 *EnterprisesEnrollmentTokensGetCall) IfNoneMatch(entityTag string) *EnterprisesEnrollmentTokensGetCall { + 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 *EnterprisesEnrollmentTokensGetCall) Context(ctx context.Context) *EnterprisesEnrollmentTokensGetCall { + 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 *EnterprisesEnrollmentTokensGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *EnterprisesEnrollmentTokensGetCall) 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/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "androidmanagement.enterprises.enrollmentTokens.get" call. +// Exactly one of *EnrollmentToken or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *EnrollmentToken.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 *EnterprisesEnrollmentTokensGetCall) Do(opts ...googleapi.CallOption) (*EnrollmentToken, 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, &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, err + } + ret := &EnrollmentToken{ + 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 an active, unexpired enrollment token. Only a partial view of EnrollmentToken is returned: all the fields but name and expiration_timestamp are empty. This method is meant to help manage active enrollment tokens lifecycle. For security reasons, it's recommended to delete active enrollment tokens as soon as they're not intended to be used anymore.", + // "flatPath": "v1/enterprises/{enterprisesId}/enrollmentTokens/{enrollmentTokensId}", + // "httpMethod": "GET", + // "id": "androidmanagement.enterprises.enrollmentTokens.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the enrollment token in the form enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.", + // "location": "path", + // "pattern": "^enterprises/[^/]+/enrollmentTokens/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "EnrollmentToken" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/androidmanagement" + // ] + // } + +} + +// method id "androidmanagement.enterprises.enrollmentTokens.list": + +type EnterprisesEnrollmentTokensListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists active, unexpired enrollment tokens for a given +// enterprise. The list items contain only a partial view of +// EnrollmentToken: all the fields but name and expiration_timestamp are +// empty. This method is meant to help manage active enrollment tokens +// lifecycle. For security reasons, it's recommended to delete active +// enrollment tokens as soon as they're not intended to be used anymore. +// +// - parent: The name of the enterprise in the form +// enterprises/{enterpriseId}. +func (r *EnterprisesEnrollmentTokensService) List(parent string) *EnterprisesEnrollmentTokensListCall { + c := &EnterprisesEnrollmentTokensListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The requested page +// size. The service may return fewer than this value. If unspecified, +// at most 10 items will be returned. The maximum value is 100; values +// above 100 will be coerced to 100. +func (c *EnterprisesEnrollmentTokensListCall) PageSize(pageSize int64) *EnterprisesEnrollmentTokensListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results returned by the server. +func (c *EnterprisesEnrollmentTokensListCall) PageToken(pageToken string) *EnterprisesEnrollmentTokensListCall { + 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 *EnterprisesEnrollmentTokensListCall) Fields(s ...googleapi.Field) *EnterprisesEnrollmentTokensListCall { + 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 *EnterprisesEnrollmentTokensListCall) IfNoneMatch(entityTag string) *EnterprisesEnrollmentTokensListCall { + 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 *EnterprisesEnrollmentTokensListCall) Context(ctx context.Context) *EnterprisesEnrollmentTokensListCall { + 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 *EnterprisesEnrollmentTokensListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *EnterprisesEnrollmentTokensListCall) 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}/enrollmentTokens") + 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 "androidmanagement.enterprises.enrollmentTokens.list" call. +// Exactly one of *ListEnrollmentTokensResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListEnrollmentTokensResponse.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 *EnterprisesEnrollmentTokensListCall) Do(opts ...googleapi.CallOption) (*ListEnrollmentTokensResponse, 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, &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, err + } + ret := &ListEnrollmentTokensResponse{ + 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 active, unexpired enrollment tokens for a given enterprise. The list items contain only a partial view of EnrollmentToken: all the fields but name and expiration_timestamp are empty. This method is meant to help manage active enrollment tokens lifecycle. For security reasons, it's recommended to delete active enrollment tokens as soon as they're not intended to be used anymore.", + // "flatPath": "v1/enterprises/{enterprisesId}/enrollmentTokens", + // "httpMethod": "GET", + // "id": "androidmanagement.enterprises.enrollmentTokens.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "The requested page size. The service may return fewer than this value. If unspecified, at most 10 items will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A token identifying a page of results returned by the server.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The name of the enterprise in the form enterprises/{enterpriseId}.", + // "location": "path", + // "pattern": "^enterprises/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/enrollmentTokens", + // "response": { + // "$ref": "ListEnrollmentTokensResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/androidmanagement" + // ] + // } + +} + +// 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 *EnterprisesEnrollmentTokensListCall) Pages(ctx context.Context, f func(*ListEnrollmentTokensResponse) 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 "androidmanagement.enterprises.policies.delete": type EnterprisesPoliciesDeleteCall struct { diff --git a/api-list.json b/api-list.json index da453b99112..0e0ae109145 100644 --- a/api-list.json +++ b/api-list.json @@ -832,7 +832,7 @@ "name": "businessprofileperformance", "version": "v1", "title": "Business Profile Performance API", - "description": "The Business Profile Performance API allows merchants to fetch performance insights about their business profile on Google.", + "description": "The Business Profile Performance API allows merchants to fetch performance reports about their business profile on Google.", "discoveryRestUrl": "https://businessprofileperformance.googleapis.com/$discovery/rest?version=v1", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index 86acdc06d10..ef2302509a7 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -1352,7 +1352,7 @@ "entries": { "methods": { "create": { - "description": "Creates key value entries in a org, env or apis scoped key value map.", + "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy.", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries", "httpMethod": "POST", "id": "apigee.organizations.apis.keyvaluemaps.entries.create", @@ -1361,7 +1361,7 @@ ], "parameters": { "parent": { - "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "required": true, @@ -1380,7 +1380,7 @@ ] }, "delete": { - "description": "Deletes a key value entry from an org, environment or apis scoped key value map.", + "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Note:** After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior.", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "httpMethod": "DELETE", "id": "apigee.organizations.apis.keyvaluemaps.entries.delete", @@ -1389,7 +1389,7 @@ ], "parameters": { "name": { - "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, @@ -1414,7 +1414,7 @@ ], "parameters": { "name": { - "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, @@ -1445,12 +1445,12 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token, a key value entry returned from a previous call that can use to retrieve the next page.", + "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Scope as indicated by the URI in which to list key value maps. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "required": true, @@ -3490,7 +3490,7 @@ ] }, "delete": { - "description": "Deletes an environment from an organization.", + "description": "Deletes an environment from an organization. **Note**: You must delete all key value maps and key value entries before you can delete an environment.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "httpMethod": "DELETE", "id": "apigee.organizations.environments.delete", @@ -5060,7 +5060,7 @@ "entries": { "methods": { "create": { - "description": "Creates key value entries in a org, env or apis scoped key value map.", + "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries", "httpMethod": "POST", "id": "apigee.organizations.environments.keyvaluemaps.entries.create", @@ -5069,7 +5069,7 @@ ], "parameters": { "parent": { - "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "required": true, @@ -5088,7 +5088,7 @@ ] }, "delete": { - "description": "Deletes a key value entry from an org, environment or apis scoped key value map.", + "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Note:** After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "httpMethod": "DELETE", "id": "apigee.organizations.environments.keyvaluemaps.entries.delete", @@ -5097,7 +5097,7 @@ ], "parameters": { "name": { - "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, @@ -5122,7 +5122,7 @@ ], "parameters": { "name": { - "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, @@ -5153,12 +5153,12 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token, a key value entry returned from a previous call that can use to retrieve the next page.", + "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Scope as indicated by the URI in which to list key value maps. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "required": true, @@ -7105,7 +7105,7 @@ "entries": { "methods": { "create": { - "description": "Creates key value entries in a org, env or apis scoped key value map.", + "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy.", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries", "httpMethod": "POST", "id": "apigee.organizations.keyvaluemaps.entries.create", @@ -7114,7 +7114,7 @@ ], "parameters": { "parent": { - "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "required": true, @@ -7133,7 +7133,7 @@ ] }, "delete": { - "description": "Deletes a key value entry from an org, environment or apis scoped key value map.", + "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Note:** After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior.", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "httpMethod": "DELETE", "id": "apigee.organizations.keyvaluemaps.entries.delete", @@ -7142,7 +7142,7 @@ ], "parameters": { "name": { - "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, @@ -7167,7 +7167,7 @@ ], "parameters": { "name": { - "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, @@ -7198,12 +7198,12 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token, a key value entry returned from a previous call that can use to retrieve the next page.", + "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Scope as indicated by the URI in which to list key value maps. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "required": true, @@ -7986,7 +7986,7 @@ } } }, - "revision": "20220527", + "revision": "20220602", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -10952,7 +10952,7 @@ "id": "GoogleCloudApigeeV1KeyValueMap", "properties": { "encrypted": { - "description": "Optional. Flag that specifies whether entry values will be encrypted. Enable to encrypt entry values.", + "description": "Optional. Flag that specifies whether entry values will be encrypted. You must set this value to `true`. Apigee X and hybrid do not support unencrytped key value maps.", "type": "boolean" }, "name": { diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 917dcbde1b7..95a92520868 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -5391,7 +5391,8 @@ func (s *GoogleCloudApigeeV1KeyValueEntry) MarshalJSON() ([]byte, error) { // GoogleCloudApigeeV1KeyValueMap: Collection of key/value string pairs. type GoogleCloudApigeeV1KeyValueMap struct { // Encrypted: Optional. Flag that specifies whether entry values will be - // encrypted. Enable to encrypt entry values. + // encrypted. You must set this value to `true`. Apigee X and hybrid do + // not support unencrytped key value maps. Encrypted bool `json:"encrypted,omitempty"` // Name: Required. ID of the key value map. @@ -16731,15 +16732,16 @@ type OrganizationsApisKeyvaluemapsEntriesCreateCall struct { header_ http.Header } -// Create: Creates key value entries in a org, env or apis scoped key -// value map. +// Create: Creates key value entries in a key value map scoped to an +// organization, environment, or API proxy. // // - parent: Scope as indicated by the URI in which to create the key -// value map entry. Use one of the following formats in your request: +// value map entry. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}` -// . +// . * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}` +// s/{keyvaluemap}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. func (r *OrganizationsApisKeyvaluemapsEntriesService) Create(parent string, googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry) *OrganizationsApisKeyvaluemapsEntriesCreateCall { c := &OrganizationsApisKeyvaluemapsEntriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -16839,7 +16841,7 @@ func (c *OrganizationsApisKeyvaluemapsEntriesCreateCall) Do(opts ...googleapi.Ca } return ret, nil // { - // "description": "Creates key value entries in a org, env or apis scoped key value map.", + // "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy.", // "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries", // "httpMethod": "POST", // "id": "apigee.organizations.apis.keyvaluemaps.entries.create", @@ -16848,7 +16850,7 @@ func (c *OrganizationsApisKeyvaluemapsEntriesCreateCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "parent": { - // "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + // "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", // "location": "path", // "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", // "required": true, @@ -16879,15 +16881,19 @@ type OrganizationsApisKeyvaluemapsEntriesDeleteCall struct { header_ http.Header } -// Delete: Deletes a key value entry from an org, environment or apis -// scoped key value map. +// Delete: Deletes a key value entry from a key value map scoped to an +// organization, environment, or API proxy. **Note:** After you delete +// the key value entry, the policy consuming the entry will continue to +// function with its cached values for a few minutes. This is expected +// behavior. // // - name: Scope as indicated by the URI in which to delete the key -// value map entry. Use one of the following formats in your request: +// value map entry. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/ -// entries/{entry}`. +// entries/{entry}`. * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}/entries/{entry}` +// s/{keyvaluemap}/entries/{entry}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{en // try}`. func (r *OrganizationsApisKeyvaluemapsEntriesService) Delete(name string) *OrganizationsApisKeyvaluemapsEntriesDeleteCall { @@ -16982,7 +16988,7 @@ func (c *OrganizationsApisKeyvaluemapsEntriesDeleteCall) Do(opts ...googleapi.Ca } return ret, nil // { - // "description": "Deletes a key value entry from an org, environment or apis scoped key value map.", + // "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Note:** After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior.", // "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", // "httpMethod": "DELETE", // "id": "apigee.organizations.apis.keyvaluemaps.entries.delete", @@ -16991,7 +16997,7 @@ func (c *OrganizationsApisKeyvaluemapsEntriesDeleteCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "name": { - // "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + // "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", // "location": "path", // "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", // "required": true, @@ -17024,11 +17030,12 @@ type OrganizationsApisKeyvaluemapsEntriesGetCall struct { // value map. // // - name: Scope as indicated by the URI in which to fetch the key value -// map entry/value. Use one of the following formats in your request: +// map entry/value. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/ -// entries/{entry}`. +// entries/{entry}`. * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}/entries/{entry}` +// s/{keyvaluemap}/entries/{entry}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{en // try}`. func (r *OrganizationsApisKeyvaluemapsEntriesService) Get(name string) *OrganizationsApisKeyvaluemapsEntriesGetCall { @@ -17145,7 +17152,7 @@ func (c *OrganizationsApisKeyvaluemapsEntriesGetCall) Do(opts ...googleapi.CallO // ], // "parameters": { // "name": { - // "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + // "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", // "location": "path", // "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", // "required": true, @@ -17178,11 +17185,11 @@ type OrganizationsApisKeyvaluemapsEntriesListCall struct { // organization, environment, or API proxy. // // - parent: Scope as indicated by the URI in which to list key value -// maps. Use one of the following formats in your request: +// maps. Use **one** of the following structures in your request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}` -// . +// . * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}` +// s/{keyvaluemap}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. func (r *OrganizationsApisKeyvaluemapsEntriesService) List(parent string) *OrganizationsApisKeyvaluemapsEntriesListCall { c := &OrganizationsApisKeyvaluemapsEntriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -17198,9 +17205,9 @@ func (c *OrganizationsApisKeyvaluemapsEntriesListCall) PageSize(pageSize int64) return c } -// PageToken sets the optional parameter "pageToken": Page token, a key -// value entry returned from a previous call that can use to retrieve -// the next page. +// PageToken sets the optional parameter "pageToken": Page token. If +// provides, must be a valid key value entry returned from a previous +// call that can be used to retrieve the next page. func (c *OrganizationsApisKeyvaluemapsEntriesListCall) PageToken(pageToken string) *OrganizationsApisKeyvaluemapsEntriesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -17322,12 +17329,12 @@ func (c *OrganizationsApisKeyvaluemapsEntriesListCall) Do(opts ...googleapi.Call // "type": "integer" // }, // "pageToken": { - // "description": "Optional. Page token, a key value entry returned from a previous call that can use to retrieve the next page.", + // "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "Required. Scope as indicated by the URI in which to list key value maps. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + // "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", // "location": "path", // "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", // "required": true, @@ -27605,7 +27612,9 @@ type OrganizationsEnvironmentsDeleteCall struct { header_ http.Header } -// Delete: Deletes an environment from an organization. +// Delete: Deletes an environment from an organization. **Note**: You +// must delete all key value maps and key value entries before you can +// delete an environment. // // - name: Name of the environment. Use the following structure in your // request: `organizations/{org}/environments/{env}`. @@ -27701,7 +27710,7 @@ func (c *OrganizationsEnvironmentsDeleteCall) Do(opts ...googleapi.CallOption) ( } return ret, nil // { - // "description": "Deletes an environment from an organization.", + // "description": "Deletes an environment from an organization. **Note**: You must delete all key value maps and key value entries before you can delete an environment.", // "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", // "httpMethod": "DELETE", // "id": "apigee.organizations.environments.delete", @@ -35629,15 +35638,16 @@ type OrganizationsEnvironmentsKeyvaluemapsEntriesCreateCall struct { header_ http.Header } -// Create: Creates key value entries in a org, env or apis scoped key -// value map. +// Create: Creates key value entries in a key value map scoped to an +// organization, environment, or API proxy. // // - parent: Scope as indicated by the URI in which to create the key -// value map entry. Use one of the following formats in your request: +// value map entry. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}` -// . +// . * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}` +// s/{keyvaluemap}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. func (r *OrganizationsEnvironmentsKeyvaluemapsEntriesService) Create(parent string, googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry) *OrganizationsEnvironmentsKeyvaluemapsEntriesCreateCall { c := &OrganizationsEnvironmentsKeyvaluemapsEntriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -35737,7 +35747,7 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesCreateCall) Do(opts ...goog } return ret, nil // { - // "description": "Creates key value entries in a org, env or apis scoped key value map.", + // "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy.", // "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries", // "httpMethod": "POST", // "id": "apigee.organizations.environments.keyvaluemaps.entries.create", @@ -35746,7 +35756,7 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesCreateCall) Do(opts ...goog // ], // "parameters": { // "parent": { - // "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + // "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", // "location": "path", // "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", // "required": true, @@ -35777,15 +35787,19 @@ type OrganizationsEnvironmentsKeyvaluemapsEntriesDeleteCall struct { header_ http.Header } -// Delete: Deletes a key value entry from an org, environment or apis -// scoped key value map. +// Delete: Deletes a key value entry from a key value map scoped to an +// organization, environment, or API proxy. **Note:** After you delete +// the key value entry, the policy consuming the entry will continue to +// function with its cached values for a few minutes. This is expected +// behavior. // // - name: Scope as indicated by the URI in which to delete the key -// value map entry. Use one of the following formats in your request: +// value map entry. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/ -// entries/{entry}`. +// entries/{entry}`. * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}/entries/{entry}` +// s/{keyvaluemap}/entries/{entry}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{en // try}`. func (r *OrganizationsEnvironmentsKeyvaluemapsEntriesService) Delete(name string) *OrganizationsEnvironmentsKeyvaluemapsEntriesDeleteCall { @@ -35880,7 +35894,7 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesDeleteCall) Do(opts ...goog } return ret, nil // { - // "description": "Deletes a key value entry from an org, environment or apis scoped key value map.", + // "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Note:** After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior.", // "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", // "httpMethod": "DELETE", // "id": "apigee.organizations.environments.keyvaluemaps.entries.delete", @@ -35889,7 +35903,7 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesDeleteCall) Do(opts ...goog // ], // "parameters": { // "name": { - // "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + // "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", // "location": "path", // "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", // "required": true, @@ -35922,11 +35936,12 @@ type OrganizationsEnvironmentsKeyvaluemapsEntriesGetCall struct { // value map. // // - name: Scope as indicated by the URI in which to fetch the key value -// map entry/value. Use one of the following formats in your request: +// map entry/value. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/ -// entries/{entry}`. +// entries/{entry}`. * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}/entries/{entry}` +// s/{keyvaluemap}/entries/{entry}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{en // try}`. func (r *OrganizationsEnvironmentsKeyvaluemapsEntriesService) Get(name string) *OrganizationsEnvironmentsKeyvaluemapsEntriesGetCall { @@ -36043,7 +36058,7 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesGetCall) Do(opts ...googlea // ], // "parameters": { // "name": { - // "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + // "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", // "location": "path", // "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", // "required": true, @@ -36076,11 +36091,11 @@ type OrganizationsEnvironmentsKeyvaluemapsEntriesListCall struct { // organization, environment, or API proxy. // // - parent: Scope as indicated by the URI in which to list key value -// maps. Use one of the following formats in your request: +// maps. Use **one** of the following structures in your request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}` -// . +// . * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}` +// s/{keyvaluemap}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. func (r *OrganizationsEnvironmentsKeyvaluemapsEntriesService) List(parent string) *OrganizationsEnvironmentsKeyvaluemapsEntriesListCall { c := &OrganizationsEnvironmentsKeyvaluemapsEntriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -36096,9 +36111,9 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesListCall) PageSize(pageSize return c } -// PageToken sets the optional parameter "pageToken": Page token, a key -// value entry returned from a previous call that can use to retrieve -// the next page. +// PageToken sets the optional parameter "pageToken": Page token. If +// provides, must be a valid key value entry returned from a previous +// call that can be used to retrieve the next page. func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesListCall) PageToken(pageToken string) *OrganizationsEnvironmentsKeyvaluemapsEntriesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -36220,12 +36235,12 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesListCall) Do(opts ...google // "type": "integer" // }, // "pageToken": { - // "description": "Optional. Page token, a key value entry returned from a previous call that can use to retrieve the next page.", + // "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "Required. Scope as indicated by the URI in which to list key value maps. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + // "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", // "location": "path", // "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", // "required": true, @@ -45418,15 +45433,16 @@ type OrganizationsKeyvaluemapsEntriesCreateCall struct { header_ http.Header } -// Create: Creates key value entries in a org, env or apis scoped key -// value map. +// Create: Creates key value entries in a key value map scoped to an +// organization, environment, or API proxy. // // - parent: Scope as indicated by the URI in which to create the key -// value map entry. Use one of the following formats in your request: +// value map entry. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}` -// . +// . * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}` +// s/{keyvaluemap}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. func (r *OrganizationsKeyvaluemapsEntriesService) Create(parent string, googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry) *OrganizationsKeyvaluemapsEntriesCreateCall { c := &OrganizationsKeyvaluemapsEntriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -45526,7 +45542,7 @@ func (c *OrganizationsKeyvaluemapsEntriesCreateCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Creates key value entries in a org, env or apis scoped key value map.", + // "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy.", // "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries", // "httpMethod": "POST", // "id": "apigee.organizations.keyvaluemaps.entries.create", @@ -45535,7 +45551,7 @@ func (c *OrganizationsKeyvaluemapsEntriesCreateCall) Do(opts ...googleapi.CallOp // ], // "parameters": { // "parent": { - // "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + // "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", // "location": "path", // "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", // "required": true, @@ -45566,15 +45582,19 @@ type OrganizationsKeyvaluemapsEntriesDeleteCall struct { header_ http.Header } -// Delete: Deletes a key value entry from an org, environment or apis -// scoped key value map. +// Delete: Deletes a key value entry from a key value map scoped to an +// organization, environment, or API proxy. **Note:** After you delete +// the key value entry, the policy consuming the entry will continue to +// function with its cached values for a few minutes. This is expected +// behavior. // // - name: Scope as indicated by the URI in which to delete the key -// value map entry. Use one of the following formats in your request: +// value map entry. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/ -// entries/{entry}`. +// entries/{entry}`. * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}/entries/{entry}` +// s/{keyvaluemap}/entries/{entry}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{en // try}`. func (r *OrganizationsKeyvaluemapsEntriesService) Delete(name string) *OrganizationsKeyvaluemapsEntriesDeleteCall { @@ -45669,7 +45689,7 @@ func (c *OrganizationsKeyvaluemapsEntriesDeleteCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Deletes a key value entry from an org, environment or apis scoped key value map.", + // "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Note:** After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior.", // "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", // "httpMethod": "DELETE", // "id": "apigee.organizations.keyvaluemaps.entries.delete", @@ -45678,7 +45698,7 @@ func (c *OrganizationsKeyvaluemapsEntriesDeleteCall) Do(opts ...googleapi.CallOp // ], // "parameters": { // "name": { - // "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + // "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", // "location": "path", // "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", // "required": true, @@ -45711,11 +45731,12 @@ type OrganizationsKeyvaluemapsEntriesGetCall struct { // value map. // // - name: Scope as indicated by the URI in which to fetch the key value -// map entry/value. Use one of the following formats in your request: +// map entry/value. Use **one** of the following structures in your +// request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/ -// entries/{entry}`. +// entries/{entry}`. * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}/entries/{entry}` +// s/{keyvaluemap}/entries/{entry}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{en // try}`. func (r *OrganizationsKeyvaluemapsEntriesService) Get(name string) *OrganizationsKeyvaluemapsEntriesGetCall { @@ -45832,7 +45853,7 @@ func (c *OrganizationsKeyvaluemapsEntriesGetCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "name": { - // "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", + // "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", // "location": "path", // "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", // "required": true, @@ -45865,11 +45886,11 @@ type OrganizationsKeyvaluemapsEntriesListCall struct { // organization, environment, or API proxy. // // - parent: Scope as indicated by the URI in which to list key value -// maps. Use one of the following formats in your request: +// maps. Use **one** of the following structures in your request: * // `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}` -// . +// . * // `organizations/{organization}/environments/{environment}/keyvaluemap -// s/{keyvaluemap}` +// s/{keyvaluemap}` * // `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. func (r *OrganizationsKeyvaluemapsEntriesService) List(parent string) *OrganizationsKeyvaluemapsEntriesListCall { c := &OrganizationsKeyvaluemapsEntriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -45885,9 +45906,9 @@ func (c *OrganizationsKeyvaluemapsEntriesListCall) PageSize(pageSize int64) *Org return c } -// PageToken sets the optional parameter "pageToken": Page token, a key -// value entry returned from a previous call that can use to retrieve -// the next page. +// PageToken sets the optional parameter "pageToken": Page token. If +// provides, must be a valid key value entry returned from a previous +// call that can be used to retrieve the next page. func (c *OrganizationsKeyvaluemapsEntriesListCall) PageToken(pageToken string) *OrganizationsKeyvaluemapsEntriesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -46009,12 +46030,12 @@ func (c *OrganizationsKeyvaluemapsEntriesListCall) Do(opts ...googleapi.CallOpti // "type": "integer" // }, // "pageToken": { - // "description": "Optional. Page token, a key value entry returned from a previous call that can use to retrieve the next page.", + // "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "Required. Scope as indicated by the URI in which to list key value maps. Use one of the following formats in your request: `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", + // "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", // "location": "path", // "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", // "required": true, diff --git a/baremetalsolution/v2/baremetalsolution-api.json b/baremetalsolution/v2/baremetalsolution-api.json index 4c13ee25fe2..14e041b5b05 100644 --- a/baremetalsolution/v2/baremetalsolution-api.json +++ b/baremetalsolution/v2/baremetalsolution-api.json @@ -908,7 +908,7 @@ "type": "string" }, "updateMask": { - "description": "The list of fields to update. The only currently supported fields are: `snapshot_auto_delete_behavior` `snapshot_schedule_policy_name` 'labels' 'requested_size_gib' 'snapshot_enabled' 'snapshot_reservation_detail.reserved_space_percent'", + "description": "The list of fields to update. The only currently supported fields are: `snapshot_auto_delete_behavior` `snapshot_schedule_policy_name` 'labels' 'snapshot_enabled' 'snapshot_reservation_detail.reserved_space_percent'", "format": "google-fieldmask", "location": "query", "type": "string" @@ -924,6 +924,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "resize": { + "description": "Emergency Volume resize.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:resize", + "httpMethod": "POST", + "id": "baremetalsolution.projects.locations.volumes.resize", + "parameterOrder": [ + "volume" + ], + "parameters": { + "volume": { + "description": "Required. Volume to resize.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+volume}:resize", + "request": { + "$ref": "ResizeVolumeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -999,7 +1027,7 @@ } } }, - "revision": "20220524", + "revision": "20220603", "rootUrl": "https://baremetalsolution.googleapis.com/", "schemas": { "AllowedClient": { @@ -1077,7 +1105,7 @@ "id": "GoogleCloudBaremetalsolutionV2LogicalInterface", "properties": { "interfaceIndex": { - "description": "The index of the logical interface mapping to the index of the hardware bond or nic on the chosen network template.", + "description": "The index of the logical interface mapping to the index of the hardware bond or nic on the chosen network template. This field is deprecated.", "format": "int32", "type": "integer" }, @@ -1830,6 +1858,10 @@ "description": "A transient unique identifier to identify a volume within an ProvisioningConfig request.", "type": "string" }, + "jumboFramesEnabled": { + "description": "The JumboFramesEnabled option for customer to set.", + "type": "boolean" + }, "name": { "description": "Output only. The name of the network config.", "readOnly": true, @@ -1976,6 +2008,11 @@ "readOnly": true, "type": "string" }, + "requestedSizeGib": { + "description": "The requested size, in GiB.", + "format": "int64", + "type": "string" + }, "state": { "description": "The state of the NFS share.", "enum": [ @@ -2143,6 +2180,10 @@ "$ref": "VolumeConfig" }, "type": "array" + }, + "vpcScEnabled": { + "description": "If true, VPC SC is enabled for the cluster.", + "type": "boolean" } }, "type": "object" @@ -2225,6 +2266,18 @@ "properties": {}, "type": "object" }, + "ResizeVolumeRequest": { + "description": "Request for emergency resize Volume.", + "id": "ResizeVolumeRequest", + "properties": { + "sizeGib": { + "description": "New Volume size, in GiB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "ServerNetworkTemplate": { "description": "Network template.", "id": "ServerNetworkTemplate", @@ -2429,11 +2482,21 @@ "description": "Labels as key value pairs.", "type": "object" }, + "maxSizeGib": { + "description": "Maximum size volume can be expanded to in case of evergency, in GiB.", + "format": "int64", + "type": "string" + }, "name": { "description": "Output only. The resource name of this `Volume`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/volumes/{volume}`", "readOnly": true, "type": "string" }, + "originallyRequestedSizeGib": { + "description": "Originally requested size, in GiB.", + "format": "int64", + "type": "string" + }, "pod": { "description": "Immutable. Pod name.", "type": "string" diff --git a/baremetalsolution/v2/baremetalsolution-gen.go b/baremetalsolution/v2/baremetalsolution-gen.go index fc67354951c..d75ca0103cf 100644 --- a/baremetalsolution/v2/baremetalsolution-gen.go +++ b/baremetalsolution/v2/baremetalsolution-gen.go @@ -378,6 +378,7 @@ func (s *FetchInstanceProvisioningSettingsResponse) MarshalJSON() ([]byte, error type GoogleCloudBaremetalsolutionV2LogicalInterface struct { // InterfaceIndex: The index of the logical interface mapping to the // index of the hardware bond or nic on the chosen network template. + // This field is deprecated. InterfaceIndex int64 `json:"interfaceIndex,omitempty"` // LogicalNetworkInterfaces: List of logical network interfaces within a @@ -1394,6 +1395,10 @@ type NetworkConfig struct { // ProvisioningConfig request. Id string `json:"id,omitempty"` + // JumboFramesEnabled: The JumboFramesEnabled option for customer to + // set. + JumboFramesEnabled bool `json:"jumboFramesEnabled,omitempty"` + // Name: Output only. The name of the network config. Name string `json:"name,omitempty"` @@ -1554,6 +1559,9 @@ type NfsShare struct { // by the backend. NfsShareId string `json:"nfsShareId,omitempty"` + // RequestedSizeGib: The requested size, in GiB. + RequestedSizeGib int64 `json:"requestedSizeGib,omitempty,string"` + // State: The state of the NFS share. // // Possible values: @@ -1752,6 +1760,9 @@ type ProvisioningConfig struct { // Volumes: Volumes to be created. Volumes []*VolumeConfig `json:"volumes,omitempty"` + // VpcScEnabled: If true, VPC SC is enabled for the cluster. + VpcScEnabled bool `json:"vpcScEnabled,omitempty"` + // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` @@ -1884,6 +1895,34 @@ func (s *QosPolicy) UnmarshalJSON(data []byte) error { type ResetInstanceRequest struct { } +// ResizeVolumeRequest: Request for emergency resize Volume. +type ResizeVolumeRequest struct { + // SizeGib: New Volume size, in GiB. + SizeGib int64 `json:"sizeGib,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "SizeGib") 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. "SizeGib") 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 *ResizeVolumeRequest) MarshalJSON() ([]byte, error) { + type NoMethod ResizeVolumeRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ServerNetworkTemplate: Network template. type ServerNetworkTemplate struct { // ApplicableInstanceTypes: Instance types this template is applicable @@ -2191,12 +2230,19 @@ type Volume struct { // Labels: Labels as key value pairs. Labels map[string]string `json:"labels,omitempty"` + // MaxSizeGib: Maximum size volume can be expanded to in case of + // evergency, in GiB. + MaxSizeGib int64 `json:"maxSizeGib,omitempty,string"` + // Name: Output only. The resource name of this `Volume`. Resource names // are schemeless URIs that follow the conventions in // https://cloud.google.com/apis/design/resource_names. Format: // `projects/{project}/locations/{location}/volumes/{volume}` Name string `json:"name,omitempty"` + // OriginallyRequestedSizeGib: Originally requested size, in GiB. + OriginallyRequestedSizeGib int64 `json:"originallyRequestedSizeGib,omitempty,string"` + // Pod: Immutable. Pod name. Pod string `json:"pod,omitempty"` @@ -6278,7 +6324,7 @@ func (r *ProjectsLocationsVolumesService) Patch(name string, volume *Volume) *Pr // UpdateMask sets the optional parameter "updateMask": The list of // fields to update. The only currently supported fields are: // `snapshot_auto_delete_behavior` `snapshot_schedule_policy_name` -// 'labels' 'requested_size_gib' 'snapshot_enabled' +// 'labels' 'snapshot_enabled' // 'snapshot_reservation_detail.reserved_space_percent' func (c *ProjectsLocationsVolumesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsVolumesPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -6392,7 +6438,7 @@ func (c *ProjectsLocationsVolumesPatchCall) Do(opts ...googleapi.CallOption) (*O // "type": "string" // }, // "updateMask": { - // "description": "The list of fields to update. The only currently supported fields are: `snapshot_auto_delete_behavior` `snapshot_schedule_policy_name` 'labels' 'requested_size_gib' 'snapshot_enabled' 'snapshot_reservation_detail.reserved_space_percent'", + // "description": "The list of fields to update. The only currently supported fields are: `snapshot_auto_delete_behavior` `snapshot_schedule_policy_name` 'labels' 'snapshot_enabled' 'snapshot_reservation_detail.reserved_space_percent'", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -6412,6 +6458,148 @@ func (c *ProjectsLocationsVolumesPatchCall) Do(opts ...googleapi.CallOption) (*O } +// method id "baremetalsolution.projects.locations.volumes.resize": + +type ProjectsLocationsVolumesResizeCall struct { + s *Service + volume string + resizevolumerequest *ResizeVolumeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Resize: Emergency Volume resize. +// +// - volume: Volume to resize. +func (r *ProjectsLocationsVolumesService) Resize(volume string, resizevolumerequest *ResizeVolumeRequest) *ProjectsLocationsVolumesResizeCall { + c := &ProjectsLocationsVolumesResizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.volume = volume + c.resizevolumerequest = resizevolumerequest + 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 *ProjectsLocationsVolumesResizeCall) Fields(s ...googleapi.Field) *ProjectsLocationsVolumesResizeCall { + 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 *ProjectsLocationsVolumesResizeCall) Context(ctx context.Context) *ProjectsLocationsVolumesResizeCall { + 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 *ProjectsLocationsVolumesResizeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVolumesResizeCall) 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.resizevolumerequest) + 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/{+volume}:resize") + 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{ + "volume": c.volume, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "baremetalsolution.projects.locations.volumes.resize" 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 *ProjectsLocationsVolumesResizeCall) 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, &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, 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": "Emergency Volume resize.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:resize", + // "httpMethod": "POST", + // "id": "baremetalsolution.projects.locations.volumes.resize", + // "parameterOrder": [ + // "volume" + // ], + // "parameters": { + // "volume": { + // "description": "Required. Volume to resize.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+volume}:resize", + // "request": { + // "$ref": "ResizeVolumeRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "baremetalsolution.projects.locations.volumes.luns.get": type ProjectsLocationsVolumesLunsGetCall struct { diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index b683a819581..c98a3577fcd 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1420,6 +1420,23 @@ "location": "path", "required": true, "type": "string" + }, + "view": { + "description": "Specifies the view that determines which table information is returned. By default, basic table information and storage statistics (STORAGE_STATS) are returned.", + "enum": [ + "BASIC", + "FULL", + "STORAGE_STATS", + "TABLE_METADATA_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "Includes basic table information including schema and partitioning specification. This view does not include storage statistics such as numRows or numBytes. This view is significantly more efficient and should be used to support high query rates.", + "Includes all table information, including storage statistics. It returns same information as STORAGE_STATS view, but may contain additional information in the future.", + "Includes all information in the BASIC view as well as storage statistics (numBytes, numLongTermBytes, numRows and lastModifiedTime).", + "The default value. Default to the STORAGE_STATS view." + ], + "location": "query", + "type": "string" } }, "path": "projects/{projectId}/datasets/{datasetId}/tables/{tableId}", @@ -1693,7 +1710,7 @@ } } }, - "revision": "20220507", + "revision": "20220528", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3763,6 +3780,31 @@ }, "type": "object" }, + "IndexUnusedReason": { + "id": "IndexUnusedReason", + "properties": { + "base_table": { + "$ref": "TableReference", + "description": "[Output-only] Specifies the base table involved in the reason that no search index was used." + }, + "code": { + "default": "$(reason.code)", + "description": "[Output-only] Specifies the high-level reason for the scenario when no search index was used.", + "type": "string" + }, + "index_name": { + "default": "$(reason.index_name)", + "description": "[Output-only] Specifies the name of the unused search index, if available.", + "type": "string" + }, + "message": { + "default": "$(reason.message)", + "description": "[Output-only] Free form human-readable reason for the scenario when no search index was used.", + "type": "string" + } + }, + "type": "object" + }, "IntArray": { "description": "An array of int.", "id": "IntArray", @@ -4646,6 +4688,10 @@ "$ref": "TableSchema", "description": "[Output-only] The schema of the results. Present only for successful dry run of non-legacy SQL queries." }, + "searchStatistics": { + "$ref": "SearchStatistics", + "description": "[Output-only] Search query specific statistics." + }, "statementType": { "description": "The type of query statement, if valid. Possible values (new values might be added in the future): \"SELECT\": SELECT query. \"INSERT\": INSERT query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. \"UPDATE\": UPDATE query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. \"DELETE\": DELETE query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. \"MERGE\": MERGE query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language. \"ALTER_TABLE\": ALTER TABLE query. \"ALTER_VIEW\": ALTER VIEW query. \"ASSERT\": ASSERT condition AS 'description'. \"CREATE_FUNCTION\": CREATE FUNCTION query. \"CREATE_MODEL\": CREATE [OR REPLACE] MODEL ... AS SELECT ... . \"CREATE_PROCEDURE\": CREATE PROCEDURE query. \"CREATE_TABLE\": CREATE [OR REPLACE] TABLE without AS SELECT. \"CREATE_TABLE_AS_SELECT\": CREATE [OR REPLACE] TABLE ... AS SELECT ... . \"CREATE_VIEW\": CREATE [OR REPLACE] VIEW ... AS SELECT ... . \"DROP_FUNCTION\" : DROP FUNCTION query. \"DROP_PROCEDURE\": DROP PROCEDURE query. \"DROP_TABLE\": DROP TABLE query. \"DROP_VIEW\": DROP VIEW query.", "type": "string" @@ -5906,6 +5952,23 @@ }, "type": "object" }, + "SearchStatistics": { + "id": "SearchStatistics", + "properties": { + "indexUnusedReason": { + "description": "When index_usage_mode is UNUSED or PARTIALLY_USED, this field explains why index was not used in all or part of the search query. If index_usage_mode is FULLLY_USED, this field is not populated.", + "items": { + "$ref": "IndexUnusedReason" + }, + "type": "array" + }, + "indexUsageMode": { + "description": "Specifies index usage mode for the query.", + "type": "string" + } + }, + "type": "object" + }, "SessionInfo": { "id": "SessionInfo", "properties": { diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index ceb2cdae166..7a473a49afc 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -3813,6 +3813,46 @@ func (s *HparamTuningTrial) UnmarshalJSON(data []byte) error { return nil } +type IndexUnusedReason struct { + // BaseTable: [Output-only] Specifies the base table involved in the + // reason that no search index was used. + BaseTable *TableReference `json:"base_table,omitempty"` + + // Code: [Output-only] Specifies the high-level reason for the scenario + // when no search index was used. + Code string `json:"code,omitempty"` + + // IndexName: [Output-only] Specifies the name of the unused search + // index, if available. + IndexName string `json:"index_name,omitempty"` + + // Message: [Output-only] Free form human-readable reason for the + // scenario when no search index was used. + Message string `json:"message,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BaseTable") 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. "BaseTable") 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 *IndexUnusedReason) MarshalJSON() ([]byte, error) { + type NoMethod IndexUnusedReason + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // IntArray: An array of int. type IntArray struct { // Elements: Elements in the int array. @@ -5105,6 +5145,9 @@ type JobStatistics2 struct { // successful dry run of non-legacy SQL queries. Schema *TableSchema `json:"schema,omitempty"` + // SearchStatistics: [Output-only] Search query specific statistics. + SearchStatistics *SearchStatistics `json:"searchStatistics,omitempty"` + // StatementType: The type of query statement, if valid. Possible values // (new values might be added in the future): "SELECT": SELECT query. // "INSERT": INSERT query; see @@ -7238,6 +7281,40 @@ func (s *ScriptStatistics) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type SearchStatistics struct { + // IndexUnusedReason: When index_usage_mode is UNUSED or PARTIALLY_USED, + // this field explains why index was not used in all or part of the + // search query. If index_usage_mode is FULLLY_USED, this field is not + // populated. + IndexUnusedReason []*IndexUnusedReason `json:"indexUnusedReason,omitempty"` + + // IndexUsageMode: Specifies index usage mode for the query. + IndexUsageMode string `json:"indexUsageMode,omitempty"` + + // ForceSendFields is a list of field names (e.g. "IndexUnusedReason") + // 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. "IndexUnusedReason") 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 *SearchStatistics) MarshalJSON() ([]byte, error) { + type NoMethod SearchStatistics + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type SessionInfo struct { // SessionId: [Output-only] // [Preview] Id of the session. SessionId string `json:"sessionId,omitempty"` @@ -14613,6 +14690,29 @@ func (c *TablesGetCall) SelectedFields(selectedFields string) *TablesGetCall { return c } +// View sets the optional parameter "view": Specifies the view that +// determines which table information is returned. By default, basic +// table information and storage statistics (STORAGE_STATS) are +// returned. +// +// Possible values: +// "BASIC" - Includes basic table information including schema and +// partitioning specification. This view does not include storage +// statistics such as numRows or numBytes. This view is significantly +// more efficient and should be used to support high query rates. +// "FULL" - Includes all table information, including storage +// statistics. It returns same information as STORAGE_STATS view, but +// may contain additional information in the future. +// "STORAGE_STATS" - Includes all information in the BASIC view as +// well as storage statistics (numBytes, numLongTermBytes, numRows and +// lastModifiedTime). +// "TABLE_METADATA_VIEW_UNSPECIFIED" - The default value. Default to +// the STORAGE_STATS view. +func (c *TablesGetCall) View(view string) *TablesGetCall { + 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. @@ -14745,6 +14845,23 @@ func (c *TablesGetCall) Do(opts ...googleapi.CallOption) (*Table, error) { // "location": "path", // "required": true, // "type": "string" + // }, + // "view": { + // "description": "Specifies the view that determines which table information is returned. By default, basic table information and storage statistics (STORAGE_STATS) are returned.", + // "enum": [ + // "BASIC", + // "FULL", + // "STORAGE_STATS", + // "TABLE_METADATA_VIEW_UNSPECIFIED" + // ], + // "enumDescriptions": [ + // "Includes basic table information including schema and partitioning specification. This view does not include storage statistics such as numRows or numBytes. This view is significantly more efficient and should be used to support high query rates.", + // "Includes all table information, including storage statistics. It returns same information as STORAGE_STATS view, but may contain additional information in the future.", + // "Includes all information in the BASIC view as well as storage statistics (numBytes, numLongTermBytes, numRows and lastModifiedTime).", + // "The default value. Default to the STORAGE_STATS view." + // ], + // "location": "query", + // "type": "string" // } // }, // "path": "projects/{projectId}/datasets/{datasetId}/tables/{tableId}", diff --git a/businessprofileperformance/v1/businessprofileperformance-api.json b/businessprofileperformance/v1/businessprofileperformance-api.json index 44be342e316..c6ba01243a8 100644 --- a/businessprofileperformance/v1/businessprofileperformance-api.json +++ b/businessprofileperformance/v1/businessprofileperformance-api.json @@ -3,7 +3,7 @@ "baseUrl": "https://businessprofileperformance.googleapis.com/", "batchPath": "batch", "canonicalName": "Business Profile Performance", - "description": "The Business Profile Performance API allows merchants to fetch performance insights about their business profile on Google.", + "description": "The Business Profile Performance API allows merchants to fetch performance reports about their business profile on Google.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/my-business/", "fullyEncodeReservedExpansion": true, @@ -99,7 +99,7 @@ "locations": { "methods": { "getDailyMetricsTimeSeries": { - "description": " Returns the values for each date from a given time range that are associated with the specific daily metric. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS\u0026daily_range.start_date.year=2022\u0026daily_range.start_date.month=1\u0026daily_range.start_date.day=1\u0026daily_range.end_date.year=2022\u0026daily_range.end_date.month=3\u0026daily_range.end_date.day=31", + "description": " Returns the values for each date from a given time range that are associated with the specific daily metric. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS\u0026daily_range.start_date.year=2022\u0026daily_range.start_date.month=1\u0026daily_range.start_date.day=1\u0026daily_range.end_date.year=2022\u0026daily_range.end_date.month=3\u0026daily_range.end_date.day=31`", "flatPath": "v1/locations/{locationsId}:getDailyMetricsTimeSeries", "httpMethod": "GET", "id": "businessprofileperformance.locations.getDailyMetricsTimeSeries", @@ -245,7 +245,7 @@ "monthly": { "methods": { "list": { - "description": "Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022\u0026monthly_range.start_month.month=1\u0026monthly_range.end_month.year=2022\u0026monthly_range.end_month.month=3", + "description": "Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022\u0026monthly_range.start_month.month=1\u0026monthly_range.end_month.year=2022\u0026monthly_range.end_month.month=3`", "flatPath": "v1/locations/{locationsId}/searchkeywords/impressions/monthly", "httpMethod": "GET", "id": "businessprofileperformance.locations.searchkeywords.impressions.monthly.list", @@ -323,7 +323,7 @@ } } }, - "revision": "20220531", + "revision": "20220606", "rootUrl": "https://businessprofileperformance.googleapis.com/", "schemas": { "Date": { diff --git a/businessprofileperformance/v1/businessprofileperformance-gen.go b/businessprofileperformance/v1/businessprofileperformance-gen.go index 3bb252ed612..d30a06cf68e 100644 --- a/businessprofileperformance/v1/businessprofileperformance-gen.go +++ b/businessprofileperformance/v1/businessprofileperformance-gen.go @@ -431,8 +431,8 @@ type LocationsGetDailyMetricsTimeSeriesCall struct { // GetDailyMetricsTimeSeries: Returns the values for each date from a // given time range that are associated with the specific daily metric. -// Example request: GET -// https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31 +// Example request: `GET +// https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31` // // - name: The location for which the time series should be fetched. // Format: locations/{location_id} where location_id is an @@ -679,7 +679,7 @@ func (c *LocationsGetDailyMetricsTimeSeriesCall) Do(opts ...googleapi.CallOption } return ret, nil // { - // "description": " Returns the values for each date from a given time range that are associated with the specific daily metric. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS\u0026daily_range.start_date.year=2022\u0026daily_range.start_date.month=1\u0026daily_range.start_date.day=1\u0026daily_range.end_date.year=2022\u0026daily_range.end_date.month=3\u0026daily_range.end_date.day=31", + // "description": " Returns the values for each date from a given time range that are associated with the specific daily metric. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS\u0026daily_range.start_date.year=2022\u0026daily_range.start_date.month=1\u0026daily_range.start_date.day=1\u0026daily_range.end_date.year=2022\u0026daily_range.end_date.month=3\u0026daily_range.end_date.day=31`", // "flatPath": "v1/locations/{locationsId}:getDailyMetricsTimeSeries", // "httpMethod": "GET", // "id": "businessprofileperformance.locations.getDailyMetricsTimeSeries", @@ -832,8 +832,8 @@ type LocationsSearchkeywordsImpressionsMonthlyListCall struct { // List: Returns the search keywords used to find a business in search // or maps. Each search keyword is accompanied by impressions which are -// aggregated on a monthly basis. Example request: GET -// https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3 +// aggregated on a monthly basis. Example request: `GET +// https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3` // // - parent: The location for which the time series should be fetched. // Format: locations/{location_id} where location_id is an @@ -1010,7 +1010,7 @@ func (c *LocationsSearchkeywordsImpressionsMonthlyListCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022\u0026monthly_range.start_month.month=1\u0026monthly_range.end_month.year=2022\u0026monthly_range.end_month.month=3", + // "description": "Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022\u0026monthly_range.start_month.month=1\u0026monthly_range.end_month.year=2022\u0026monthly_range.end_month.month=3`", // "flatPath": "v1/locations/{locationsId}/searchkeywords/impressions/monthly", // "httpMethod": "GET", // "id": "businessprofileperformance.locations.searchkeywords.impressions.monthly.list", diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 346ad0717b5..e56a8c05b56 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -449,6 +449,12 @@ "pattern": "^customers/[^/]+/telemetry/devices/[^/]+$", "required": true, "type": "string" + }, + "readMask": { + "description": "Required. Read mask to specify which fields to return.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } }, "path": "v1/{+name}", @@ -513,7 +519,7 @@ } } }, - "revision": "20220512", + "revision": "20220606", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index d3200d36d7e..bf48041007a 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -3416,6 +3416,13 @@ func (r *CustomersTelemetryDevicesService) Get(name string) *CustomersTelemetryD return c } +// ReadMask sets the optional parameter "readMask": Required. Read mask +// to specify which fields to return. +func (c *CustomersTelemetryDevicesGetCall) ReadMask(readMask string) *CustomersTelemetryDevicesGetCall { + c.urlParams_.Set("readMask", readMask) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -3530,6 +3537,12 @@ func (c *CustomersTelemetryDevicesGetCall) Do(opts ...googleapi.CallOption) (*Go // "pattern": "^customers/[^/]+/telemetry/devices/[^/]+$", // "required": true, // "type": "string" + // }, + // "readMask": { + // "description": "Required. Read mask to specify which fields to return.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" // } // }, // "path": "v1/{+name}", diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 635caef033c..753da5fb210 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -929,7 +929,7 @@ } } }, - "revision": "20220528", + "revision": "20220604", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -3220,7 +3220,7 @@ "type": "object" }, "ResourceSearchResult": { - "description": "A result of Resource Search, containing information of a cloud resource.", + "description": "A result of Resource Search, containing information of a cloud resource. Next ID: 28", "id": "ResourceSearchResult", "properties": { "additionalAttributes": { diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 2cbe891cbb4..3210e9b0cf9 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -4838,7 +4838,7 @@ func (s *Resource) MarshalJSON() ([]byte, error) { } // ResourceSearchResult: A result of Resource Search, containing -// information of a cloud resource. +// information of a cloud resource. Next ID: 28 type ResourceSearchResult struct { // AdditionalAttributes: The additional searchable attributes of this // resource. The attributes may vary from one resource type to another. diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index a0a5647980f..54207376072 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -1901,7 +1901,7 @@ } } }, - "revision": "20220422", + "revision": "20220604", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -3864,6 +3864,31 @@ }, "type": "object" }, + "GoogleCloudChannelV1alpha1ChannelPartnerEvent": { + "description": "Represents Pub/Sub messages about updates to a Channel Partner. You can retrieve updated values through the ChannelPartnerLinks API.", + "id": "GoogleCloudChannelV1alpha1ChannelPartnerEvent", + "properties": { + "channelPartner": { + "description": "Resource name for the Channel Partner Link. Channel_partner uses the format: accounts/{account_id}/channelPartnerLinks/{channel_partner_id}", + "type": "string" + }, + "eventType": { + "description": "Type of event performed on the Channel Partner.", + "enum": [ + "TYPE_UNSPECIFIED", + "LINK_STATE_CHANGED", + "PARTNER_ADVANTAGE_INFO_CHANGED" + ], + "enumDescriptions": [ + "Default value. Does not display if there are no errors.", + "The Channel Partner link state changed.", + "The Channel Partner's Partner Advantage information changed. This can entail the Channel Partner's authorization to sell a product in a particular region." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudChannelV1alpha1CommitmentSettings": { "description": "Commitment settings for commitment-based offers.", "id": "GoogleCloudChannelV1alpha1CommitmentSettings", @@ -4254,6 +4279,10 @@ "description": "Represents information which resellers will get as part of notification from Pub/Sub.", "id": "GoogleCloudChannelV1alpha1SubscriberEvent", "properties": { + "channelPartnerEvent": { + "$ref": "GoogleCloudChannelV1alpha1ChannelPartnerEvent", + "description": "Channel Partner event sent as part of Pub/Sub event to partners." + }, "customerEvent": { "$ref": "GoogleCloudChannelV1alpha1CustomerEvent", "description": "Customer event sent as part of Pub/Sub event to partners." diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index b3584aacb65..a2b945f0659 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -3693,6 +3693,50 @@ func (s *GoogleCloudChannelV1alpha1AssociationInfo) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudChannelV1alpha1ChannelPartnerEvent: Represents Pub/Sub +// messages about updates to a Channel Partner. You can retrieve updated +// values through the ChannelPartnerLinks API. +type GoogleCloudChannelV1alpha1ChannelPartnerEvent struct { + // ChannelPartner: Resource name for the Channel Partner Link. + // Channel_partner uses the format: + // accounts/{account_id}/channelPartnerLinks/{channel_partner_id} + ChannelPartner string `json:"channelPartner,omitempty"` + + // EventType: Type of event performed on the Channel Partner. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. Does not display if there are + // no errors. + // "LINK_STATE_CHANGED" - The Channel Partner link state changed. + // "PARTNER_ADVANTAGE_INFO_CHANGED" - The Channel Partner's Partner + // Advantage information changed. This can entail the Channel Partner's + // authorization to sell a product in a particular region. + EventType string `json:"eventType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ChannelPartner") 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. "ChannelPartner") 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 *GoogleCloudChannelV1alpha1ChannelPartnerEvent) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudChannelV1alpha1ChannelPartnerEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudChannelV1alpha1CommitmentSettings: Commitment settings for // commitment-based offers. type GoogleCloudChannelV1alpha1CommitmentSettings struct { @@ -4202,6 +4246,10 @@ func (s *GoogleCloudChannelV1alpha1RenewalSettings) MarshalJSON() ([]byte, error // GoogleCloudChannelV1alpha1SubscriberEvent: Represents information // which resellers will get as part of notification from Pub/Sub. type GoogleCloudChannelV1alpha1SubscriberEvent struct { + // ChannelPartnerEvent: Channel Partner event sent as part of Pub/Sub + // event to partners. + ChannelPartnerEvent *GoogleCloudChannelV1alpha1ChannelPartnerEvent `json:"channelPartnerEvent,omitempty"` + // CustomerEvent: Customer event sent as part of Pub/Sub event to // partners. CustomerEvent *GoogleCloudChannelV1alpha1CustomerEvent `json:"customerEvent,omitempty"` @@ -4210,20 +4258,21 @@ type GoogleCloudChannelV1alpha1SubscriberEvent struct { // partners. EntitlementEvent *GoogleCloudChannelV1alpha1EntitlementEvent `json:"entitlementEvent,omitempty"` - // ForceSendFields is a list of field names (e.g. "CustomerEvent") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "ChannelPartnerEvent") + // 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. "CustomerEvent") 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. "ChannelPartnerEvent") 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/cloudsearch/v1/cloudsearch-api.json b/cloudsearch/v1/cloudsearch-api.json index 410f1b2e50c..401dd53f4de 100644 --- a/cloudsearch/v1/cloudsearch-api.json +++ b/cloudsearch/v1/cloudsearch-api.json @@ -396,7 +396,7 @@ "type": "boolean" }, "name": { - "description": "Name of the data source to delete Schema. Format: datasources/{source_id}", + "description": "The name of the data source to delete Schema. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -428,7 +428,7 @@ "type": "boolean" }, "name": { - "description": "Name of the data source to get Schema. Format: datasources/{source_id}", + "description": "The name of the data source to get Schema. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -455,7 +455,7 @@ ], "parameters": { "name": { - "description": "Name of the data source to update Schema. Format: datasources/{source_id}", + "description": "The name of the data source to update Schema. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -489,7 +489,7 @@ ], "parameters": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "location": "query", "type": "string" }, @@ -506,7 +506,7 @@ "ASYNCHRONOUS" ], "enumDescriptions": [ - "Priority is not specified in the update request. Leaving priority unspecified results in an update failure.", + "The priority is not specified in the update request. Leaving priority unspecified results in an update failure.", "For real-time updates.", "For changes that are executed after the response is sent back to the caller." ], @@ -514,7 +514,7 @@ "type": "string" }, "name": { - "description": "Required. Name of the item to delete. Format: datasources/{source_id}/items/{item_id}", + "description": "Required. The name of the item to delete. Format: datasources/{source_id}/items/{item_id}", "location": "path", "pattern": "^datasources/[^/]+/items/[^/]+$", "required": true, @@ -546,7 +546,7 @@ ], "parameters": { "name": { - "description": "Name of the Data Source to delete items in a queue. Format: datasources/{source_id}", + "description": "The name of the Data Source to delete items in a queue. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -575,7 +575,7 @@ ], "parameters": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "location": "query", "type": "string" }, @@ -585,7 +585,7 @@ "type": "boolean" }, "name": { - "description": "Name of the item to get info. Format: datasources/{source_id}/items/{item_id}", + "description": "The name of the item to get info. Format: datasources/{source_id}/items/{item_id}", "location": "path", "pattern": "^datasources/[^/]+/items/[^/]+$", "required": true, @@ -611,7 +611,7 @@ ], "parameters": { "name": { - "description": "Name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.", + "description": "The name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.", "location": "path", "pattern": "^datasources/[^/]+/items/[^/]+$", "required": true, @@ -645,7 +645,7 @@ "type": "boolean" }, "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "location": "query", "type": "string" }, @@ -655,7 +655,7 @@ "type": "boolean" }, "name": { - "description": "Name of the Data Source to list Items. Format: datasources/{source_id}", + "description": "The name of the Data Source to list Items. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -692,7 +692,7 @@ ], "parameters": { "name": { - "description": "Name of the Data Source to poll items. Format: datasources/{source_id}", + "description": "The name of the Data Source to poll items. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -721,7 +721,7 @@ ], "parameters": { "name": { - "description": "Name of the item to push into the indexing queue. Format: datasources/{source_id}/items/{ID} This is a required field. The maximum length is 1536 characters.", + "description": "The name of the item to push into the indexing queue. Format: datasources/{source_id}/items/{ID} This is a required field. The maximum length is 1536 characters.", "location": "path", "pattern": "^datasources/[^/]+/items/[^/]+$", "required": true, @@ -750,7 +750,7 @@ ], "parameters": { "name": { - "description": "Name of the Data Source to unreserve all items. Format: datasources/{source_id}", + "description": "The name of the Data Source to unreserve all items. Format: datasources/{source_id}", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -779,7 +779,7 @@ ], "parameters": { "name": { - "description": "Name of the Item to start a resumable upload. Format: datasources/{source_id}/items/{item_id}. The maximum length is 1536 bytes.", + "description": "The name of the Item to start a resumable upload. Format: datasources/{source_id}/items/{item_id}. The maximum length is 1536 bytes.", "location": "path", "pattern": "^datasources/[^/]+/items/[^/]+$", "required": true, @@ -1110,7 +1110,7 @@ "type": "boolean" }, "name": { - "description": "Name of the datasource. Format: datasources/{source_id}.", + "description": "The name of the datasource. Format: datasources/{source_id}.", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -1142,7 +1142,7 @@ "type": "boolean" }, "name": { - "description": "Name of the datasource resource. Format: datasources/{source_id}.", + "description": "The name of the datasource resource. Format: datasources/{source_id}.", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -1203,7 +1203,7 @@ ], "parameters": { "name": { - "description": "Name of the datasource resource. Format: datasources/{source_id}. The name is ignored when creating a datasource.", + "description": "The name of the datasource resource. Format: datasources/{source_id}. The name is ignored when creating a datasource.", "location": "path", "pattern": "^datasources/[^/]+$", "required": true, @@ -1294,7 +1294,7 @@ "type": "boolean" }, "name": { - "description": "Name of the search application. Format: searchapplications/{application_id}.", + "description": "The name of the search application. Format: searchapplications/{application_id}.", "location": "path", "pattern": "^searchapplications/[^/]+$", "required": true, @@ -1385,7 +1385,7 @@ ], "parameters": { "name": { - "description": "Name of the Search Application. Format: searchapplications/{application_id}.", + "description": "The name of the Search Application. Format: searchapplications/{application_id}.", "location": "path", "pattern": "^searchapplications/[^/]+$", "required": true, @@ -1994,7 +1994,7 @@ } } }, - "revision": "20220524", + "revision": "20220530", "rootUrl": "https://cloudsearch.googleapis.com/", "schemas": { "AclInfo": { @@ -2136,7 +2136,7 @@ "type": "object" }, "BooleanPropertyOptions": { - "description": "Options for boolean properties.", + "description": "The options for boolean properties.", "id": "BooleanPropertyOptions", "properties": { "operatorOptions": { @@ -2289,7 +2289,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which statistics were calculated." + "description": "The date for which statistics were calculated." }, "itemCountByStatus": { "description": "Number of items aggregrated by status code.", @@ -2306,7 +2306,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which query stats were calculated. Stats calculated on the next day close to midnight are returned." + "description": "The date for which query stats were calculated. Stats calculated on the next day close to midnight are returned." }, "queryCountByStatus": { "items": { @@ -2328,7 +2328,7 @@ }, "date": { "$ref": "Date", - "description": "Date for which search application stats were calculated." + "description": "The date for which search application stats were calculated." } }, "type": "object" @@ -2338,7 +2338,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which session stats were calculated. Stats are calculated on the following day, close to midnight PST, and then returned." + "description": "The date for which session stats were calculated. Stats are calculated on the following day, close to midnight PST, and then returned." }, "searchSessionsCount": { "description": "The count of search sessions on the day", @@ -2368,7 +2368,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which session stats were calculated. Stats calculated on the next day close to midnight are returned." + "description": "The date for which session stats were calculated. Stats calculated on the next day close to midnight are returned." }, "oneDayActiveUsersCount": { "description": "The count of unique active users in the past one day", @@ -2419,7 +2419,7 @@ "type": "array" }, "name": { - "description": "Name of the datasource resource. Format: datasources/{source_id}. The name is ignored when creating a datasource.", + "description": "The name of the datasource resource. Format: datasources/{source_id}. The name is ignored when creating a datasource.", "type": "string" }, "operationIds": { @@ -2446,7 +2446,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which index stats were calculated. If the date of request is not the current date then stats calculated on the next day are returned. Stats are calculated close to mid night in this case. If date of request is current date, then real time stats are returned." + "description": "The date for which index stats were calculated. If the date of request is not the current date then stats calculated on the next day are returned. Stats are calculated close to mid night in this case. If date of request is current date, then real time stats are returned." }, "itemCountByStatus": { "description": "Number of items aggregrated by status code.", @@ -2518,7 +2518,7 @@ "type": "object" }, "DatePropertyOptions": { - "description": "Options for date properties.", + "description": "The options for date properties.", "id": "DatePropertyOptions", "properties": { "operatorOptions": { @@ -2556,7 +2556,7 @@ "id": "DeleteQueueItemsRequest", "properties": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "type": "string" }, "debugOptions": { @@ -2564,7 +2564,7 @@ "description": "Common debug options." }, "queue": { - "description": "Name of a queue to delete items from.", + "description": "The name of a queue to delete items from.", "type": "string" } }, @@ -2603,7 +2603,7 @@ "type": "object" }, "DoublePropertyOptions": { - "description": "Options for double properties.", + "description": "The options for double properties.", "id": "DoublePropertyOptions", "properties": { "operatorOptions": { @@ -2845,7 +2845,7 @@ "type": "object" }, "EnumPropertyOptions": { - "description": "Options for enum properties, which allow you to define a restricted set of strings to match user queries, set rankings for those string values, and define an operator name to be paired with those strings so that users can narrow results to only items with a specific value. For example, for items in a request tracking system with priority information, you could define *p0* as an allowable enum value and tie this enum to the operator name *priority* so that search users could add *priority:p0* to their query to restrict the set of results to only those items indexed with the value *p0*.", + "description": "The options for enum properties, which allow you to define a restricted set of strings to match user queries, set rankings for those string values, and define an operator name to be paired with those strings so that users can narrow results to only items with a specific value. For example, for items in a request tracking system with priority information, you could define *p0* as an allowable enum value and tie this enum to the operator name *priority* so that search users could add *priority:p0* to their query to restrict the set of results to only those items indexed with the value *p0*.", "id": "EnumPropertyOptions", "properties": { "operatorOptions": { @@ -2966,7 +2966,7 @@ "type": "string" }, "operatorName": { - "description": "Name of the operator chosen for faceting. @see cloudsearch.SchemaPropertyOptions", + "description": "The name of the operator chosen for faceting. @see cloudsearch.SchemaPropertyOptions", "type": "string" }, "sourceName": { @@ -2992,7 +2992,7 @@ "type": "string" }, "operatorName": { - "description": "Name of the operator chosen for faceting. @see cloudsearch.SchemaPropertyOptions", + "description": "The name of the operator chosen for faceting. @see cloudsearch.SchemaPropertyOptions", "type": "string" }, "sourceName": { @@ -3006,7 +3006,7 @@ "id": "FieldViolation", "properties": { "description": { - "description": "Description of the error.", + "description": "The description of the error.", "type": "string" }, "field": { @@ -3346,7 +3346,7 @@ "type": "object" }, "HtmlPropertyOptions": { - "description": "Options for html properties.", + "description": "The options for html properties.", "id": "HtmlPropertyOptions", "properties": { "operatorOptions": { @@ -3409,7 +3409,7 @@ "id": "IndexItemRequest", "properties": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "type": "string" }, "debugOptions": { @@ -3421,7 +3421,7 @@ }, "item": { "$ref": "Item", - "description": "Name of the item. Format: datasources/{source_id}/items/{item_id}" + "description": "The name of the item. Format: datasources/{source_id}/items/{item_id}" }, "mode": { "description": "Required. The RequestMode for this request.", @@ -3431,7 +3431,7 @@ "ASYNCHRONOUS" ], "enumDescriptions": [ - "Priority is not specified in the update request. Leaving priority unspecified results in an update failure.", + "The priority is not specified in the update request. Leaving priority unspecified results in an update failure.", "For real-time updates.", "For changes that are executed after the response is sent back to the caller." ], @@ -3466,7 +3466,7 @@ "type": "object" }, "IntegerPropertyOptions": { - "description": "Options for integer properties.", + "description": "The options for integer properties.", "id": "IntegerPropertyOptions", "properties": { "maximumValue": { @@ -3556,7 +3556,7 @@ "description": "Item content to be indexed and made text searchable." }, "itemType": { - "description": "Type for this item.", + "description": "The type for this item.", "enum": [ "UNSPECIFIED", "CONTENT_ITEM", @@ -3573,10 +3573,10 @@ }, "metadata": { "$ref": "ItemMetadata", - "description": "Metadata information." + "description": "The metadata information." }, "name": { - "description": "Name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.", + "description": "The name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.", "type": "string" }, "payload": { @@ -3605,7 +3605,7 @@ "type": "object" }, "ItemAcl": { - "description": "Access control list information for the item. For more information see [Map ACLs](/cloud-search/docs/guides/acls).", + "description": "Access control list information for the item. For more information see [Map ACLs](https://developers.google.com/cloud-search/docs/guides/acls).", "id": "ItemAcl", "properties": { "aclInheritanceType": { @@ -3632,7 +3632,7 @@ "type": "array" }, "inheritAclFrom": { - "description": "Name of the item to inherit the Access Permission List (ACL) from. Note: ACL inheritance *only* provides access permissions to child items and does not define structural relationships, nor does it provide convenient ways to delete large groups of items. Deleting an ACL parent from the index only alters the access permissions of child items that reference the parent in the inheritAclFrom field. The item is still in the index, but may not visible in search results. By contrast, deletion of a container item also deletes all items that reference the container via the containerName field. The maximum length for this field is 1536 characters.", + "description": "The name of the item to inherit the Access Permission List (ACL) from. Note: ACL inheritance *only* provides access permissions to child items and does not define structural relationships, nor does it provide convenient ways to delete large groups of items. Deleting an ACL parent from the index only alters the access permissions of child items that reference the parent in the inheritAclFrom field. The item is still in the index, but may not visible in search results. By contrast, deletion of a container item also deletes all items that reference the container via the containerName field. The maximum length for this field is 1536 characters.", "type": "string" }, "owners": { @@ -4054,7 +4054,7 @@ "id": "Name", "properties": { "displayName": { - "description": "The read-only display name formatted according to the locale specified by the viewer's account or the Accept-Language HTTP header.", + "description": "The read-only display name formatted according to the locale specified by the viewer's account or the `Accept-Language` HTTP header.", "type": "string" } }, @@ -4103,7 +4103,7 @@ "id": "ObjectDefinition", "properties": { "name": { - "description": "Name for the object, which then defines its type. Item indexing requests should set the objectType field equal to this value. For example, if *name* is *Document*, then indexing requests for items of type Document should set objectType equal to *Document*. Each object definition must be uniquely named within a schema. The name must start with a letter and can only contain letters (A-Z, a-z) or numbers (0-9). The maximum length is 256 characters.", + "description": "The name for the object, which then defines its type. Item indexing requests should set the objectType field equal to this value. For example, if *name* is *Document*, then indexing requests for items of type Document should set objectType equal to *Document*. Each object definition must be uniquely named within a schema. The name must start with a letter and can only contain letters (A-Z, a-z) or numbers (0-9). The maximum length is 256 characters.", "type": "string" }, "options": { @@ -4144,7 +4144,7 @@ "properties": { "displayOptions": { "$ref": "ObjectDisplayOptions", - "description": "Options that determine how the object is displayed in the Cloud Search results page." + "description": "The options that determine how the object is displayed in the Cloud Search results page." }, "freshnessOptions": { "$ref": "FreshnessOptions", @@ -4154,7 +4154,7 @@ "type": "object" }, "ObjectPropertyOptions": { - "description": "Options for object properties.", + "description": "The options for object properties.", "id": "ObjectPropertyOptions", "properties": { "subobjectProperties": { @@ -4238,7 +4238,7 @@ "type": "array" }, "name": { - "description": "The resource name of the person to provide information about. See People.get from Google People API.", + "description": "The resource name of the person to provide information about. See [`People.get`](https://developers.google.com/people/api/rest/v1/people/get) from the Google People API.", "type": "string" }, "obfuscatedId": { @@ -4277,7 +4277,7 @@ "id": "PollItemsRequest", "properties": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "type": "string" }, "debugOptions": { @@ -4371,7 +4371,7 @@ "type": "string" }, "errorMessage": { - "description": "Description of the error.", + "description": "The description of the error.", "type": "string" }, "fieldViolations": { @@ -4396,7 +4396,7 @@ }, "displayOptions": { "$ref": "PropertyDisplayOptions", - "description": "Options that determine how the property is displayed in the Cloud Search results page if it is specified to be displayed in the object's display options ." + "description": "The options that determine how the property is displayed in the Cloud Search results page if it's specified to be displayed in the object's display options." }, "doublePropertyOptions": { "$ref": "DoublePropertyOptions" @@ -4411,7 +4411,7 @@ "$ref": "IntegerPropertyOptions" }, "isFacetable": { - "description": "Indicates that the property can be used for generating facets. Cannot be true for properties whose type is object. IsReturnable must be true to set this option. Only supported for Boolean, Enum, and Text properties.", + "description": "Indicates that the property can be used for generating facets. Cannot be true for properties whose type is object. IsReturnable must be true to set this option. Only supported for boolean, enum, and text properties.", "type": "boolean" }, "isRepeatable": { @@ -4423,7 +4423,7 @@ "type": "boolean" }, "isSortable": { - "description": "Indicates that the property can be used for sorting. Cannot be true for properties that are repeatable. Cannot be true for properties whose type is object. IsReturnable must be true to set this option. Only supported for Boolean, Date, Double, Integer, and Timestamp properties.", + "description": "Indicates that the property can be used for sorting. Cannot be true for properties that are repeatable. Cannot be true for properties whose type is object. IsReturnable must be true to set this option. Only supported for boolean, date, double, integer, and timestamp properties.", "type": "boolean" }, "isSuggestable": { @@ -4470,7 +4470,7 @@ "type": "string" }, "metadataHash": { - "description": "Metadata hash of the item according to the repository. If specified, this is used to determine how to modify this item's status. Setting this field and the type field results in argument error. The maximum length is 2048 characters.", + "description": "The metadata hash of the item according to the repository. If specified, this is used to determine how to modify this item's status. Setting this field and the type field results in argument error. The maximum length is 2048 characters.", "type": "string" }, "payload": { @@ -4479,7 +4479,7 @@ "type": "string" }, "queue": { - "description": "Queue to which this item belongs to. The default queue is chosen if this field is not specified. The maximum length is 512 characters.", + "description": "Queue to which this item belongs. The `default` queue is chosen if this field is not specified. The maximum length is 512 characters.", "type": "string" }, "repositoryError": { @@ -4515,7 +4515,7 @@ "id": "PushItemRequest", "properties": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "type": "string" }, "debugOptions": { @@ -4670,7 +4670,7 @@ "type": "string" }, "objectType": { - "description": "Name of the object corresponding to the operator. This field is only filled for schema-specific operators, and is unset for common operators.", + "description": "The name of the object corresponding to the operator. This field is only filled for schema-specific operators, and is unset for common operators.", "type": "string" }, "operatorName": { @@ -4678,7 +4678,7 @@ "type": "string" }, "type": { - "description": "Type of the operator.", + "description": "The type of the operator.", "enum": [ "UNKNOWN", "INTEGER", @@ -4727,7 +4727,7 @@ }, "source": { "$ref": "Source", - "description": "Name of the source" + "description": "The name of the source" } }, "type": "object" @@ -4752,7 +4752,7 @@ "type": "integer" }, "type": { - "description": "Type of error.", + "description": "The type of error.", "enum": [ "UNKNOWN", "NETWORK_ERROR", @@ -5015,7 +5015,7 @@ "type": "boolean" }, "name": { - "description": "Name of the Search Application. Format: searchapplications/{application_id}.", + "description": "The name of the Search Application. Format: searchapplications/{application_id}.", "type": "string" }, "operationIds": { @@ -5054,7 +5054,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which query stats were calculated. Stats calculated on the next day close to midnight are returned." + "description": "The date for which query stats were calculated. Stats calculated on the next day close to midnight are returned." }, "queryCountByStatus": { "items": { @@ -5070,7 +5070,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which session stats were calculated. Stats are calculated on the following day, close to midnight PST, and then returned." + "description": "The date for which session stats were calculated. Stats are calculated on the following day, close to midnight PST, and then returned." }, "searchSessionsCount": { "description": "The count of search sessions on the day", @@ -5085,7 +5085,7 @@ "properties": { "date": { "$ref": "Date", - "description": "Date for which session stats were calculated. Stats calculated on the next day close to midnight are returned." + "description": "The date for which session stats were calculated. Stats calculated on the next day close to midnight are returned." }, "oneDayActiveUsersCount": { "description": "The count of unique active users in the past one day", @@ -5355,7 +5355,7 @@ "id": "SortOptions", "properties": { "operatorName": { - "description": "Name of the operator corresponding to the field to sort on. The corresponding property must be marked as sortable.", + "description": "The name of the operator corresponding to the field to sort on. The corresponding property must be marked as sortable.", "type": "string" }, "sortOrder": { @@ -5570,7 +5570,7 @@ "id": "StartUploadItemRequest", "properties": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "type": "string" }, "debugOptions": { @@ -5696,7 +5696,7 @@ "id": "TextOperatorOptions", "properties": { "exactMatchWithOperator": { - "description": "If true, the text value is tokenized as one atomic value in operator searches and facet matches. For example, if the operator name is \"genre\" and the value is \"science-fiction\" the query restrictions \"genre:science\" and \"genre:fiction\" doesn't match the item; \"genre:science-fiction\" does. Value matching is case-sensitive and does not remove special characters. If false, the text is tokenized. For example, if the value is \"science-fiction\" the queries \"genre:science\" and \"genre:fiction\" matches the item.", + "description": "If true, the text value is tokenized as one atomic value in operator searches and facet matches. For example, if the operator name is \"genre\" and the value is \"science-fiction\" the query restrictions \"genre:science\" and \"genre:fiction\" doesn't match the item; \"genre:science-fiction\" does. Text value matching is case-sensitive and does not remove special characters. If false, the text is tokenized. For example, if the value is \"science-fiction\" the queries \"genre:science\" and \"genre:fiction\" matches the item.", "type": "boolean" }, "operatorName": { @@ -5707,7 +5707,7 @@ "type": "object" }, "TextPropertyOptions": { - "description": "Options for text properties.", + "description": "The options for text properties.", "id": "TextPropertyOptions", "properties": { "operatorOptions": { @@ -5755,7 +5755,7 @@ "type": "object" }, "TimestampPropertyOptions": { - "description": "Options for timestamp properties.", + "description": "The options for timestamp properties.", "id": "TimestampPropertyOptions", "properties": { "operatorOptions": { @@ -5824,7 +5824,7 @@ "id": "UnreserveItemsRequest", "properties": { "connectorName": { - "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", "type": "string" }, "debugOptions": { @@ -5832,7 +5832,7 @@ "description": "Common debug options." }, "queue": { - "description": "Name of a queue to unreserve items from.", + "description": "The name of a queue to unreserve items from.", "type": "string" } }, @@ -5874,7 +5874,7 @@ "id": "UploadItemRef", "properties": { "name": { - "description": "Name of the content reference. The maximum length is 2048 characters.", + "description": "The name of the content reference. The maximum length is 2048 characters.", "type": "string" } }, diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index 99574db0c51..a69eb2e1c69 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -717,7 +717,7 @@ func (s *BooleanOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BooleanPropertyOptions: Options for boolean properties. +// BooleanPropertyOptions: The options for boolean properties. type BooleanPropertyOptions struct { // OperatorOptions: If set, describes how the boolean should be used as // a search operator. @@ -977,7 +977,7 @@ func (s *CustomerId) MarshalJSON() ([]byte, error) { // CustomerIndexStats: Aggregation of items by status code as of the // specified date. type CustomerIndexStats struct { - // Date: Date for which statistics were calculated. + // Date: The date for which statistics were calculated. Date *Date `json:"date,omitempty"` // ItemCountByStatus: Number of items aggregrated by status code. @@ -1007,8 +1007,8 @@ func (s *CustomerIndexStats) MarshalJSON() ([]byte, error) { } type CustomerQueryStats struct { - // Date: Date for which query stats were calculated. Stats calculated on - // the next day close to midnight are returned. + // Date: The date for which query stats were calculated. Stats + // calculated on the next day close to midnight are returned. Date *Date `json:"date,omitempty"` QueryCountByStatus []*QueryCountByStatus `json:"queryCountByStatus,omitempty"` @@ -1042,7 +1042,7 @@ type CustomerSearchApplicationStats struct { // Count: The count of search applications for the date. Count int64 `json:"count,omitempty,string"` - // Date: Date for which search application stats were calculated. + // Date: The date for which search application stats were calculated. Date *Date `json:"date,omitempty"` // ForceSendFields is a list of field names (e.g. "Count") to @@ -1069,7 +1069,7 @@ func (s *CustomerSearchApplicationStats) MarshalJSON() ([]byte, error) { } type CustomerSessionStats struct { - // Date: Date for which session stats were calculated. Stats are + // Date: The date for which session stats were calculated. Stats are // calculated on the following day, close to midnight PST, and then // returned. Date *Date `json:"date,omitempty"` @@ -1142,8 +1142,8 @@ func (s *CustomerSettings) MarshalJSON() ([]byte, error) { } type CustomerUserStats struct { - // Date: Date for which session stats were calculated. Stats calculated - // on the next day close to midnight are returned. + // Date: The date for which session stats were calculated. Stats + // calculated on the next day close to midnight are returned. Date *Date `json:"date,omitempty"` // OneDayActiveUsersCount: The count of unique active users in the past @@ -1211,7 +1211,7 @@ type DataSource struct { // shared outside this visibility. ItemsVisibility []*GSuitePrincipal `json:"itemsVisibility,omitempty"` - // Name: Name of the datasource resource. Format: + // Name: The name of the datasource resource. Format: // datasources/{source_id}. The name is ignored when creating a // datasource. Name string `json:"name,omitempty"` @@ -1267,7 +1267,7 @@ func (s *DataSource) MarshalJSON() ([]byte, error) { // DataSourceIndexStats: Aggregation of items by status code as of the // specified date. type DataSourceIndexStats struct { - // Date: Date for which index stats were calculated. If the date of + // Date: The date for which index stats were calculated. If the date of // request is not the current date then stats calculated on the next day // are returned. Stats are calculated close to mid night in this case. // If date of request is current date, then real time stats are @@ -1439,7 +1439,7 @@ func (s *DateOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// DatePropertyOptions: Options for date properties. +// DatePropertyOptions: The options for date properties. type DatePropertyOptions struct { // OperatorOptions: If set, describes how the date should be used as a // search operator. @@ -1528,14 +1528,14 @@ func (s *DebugOptions) MarshalJSON() ([]byte, error) { } type DeleteQueueItemsRequest struct { - // ConnectorName: Name of connector making this call. Format: + // ConnectorName: The name of connector making this call. Format: // datasources/{source_id}/connectors/{ID} ConnectorName string `json:"connectorName,omitempty"` // DebugOptions: Common debug options. DebugOptions *DebugOptions `json:"debugOptions,omitempty"` - // Queue: Name of a queue to delete items from. + // Queue: The name of a queue to delete items from. Queue string `json:"queue,omitempty"` // ForceSendFields is a list of field names (e.g. "ConnectorName") to @@ -1656,7 +1656,7 @@ func (s *DoubleOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// DoublePropertyOptions: Options for double properties. +// DoublePropertyOptions: The options for double properties. type DoublePropertyOptions struct { // OperatorOptions: If set, describes how the double should be used as a // search operator. @@ -2055,8 +2055,8 @@ func (s *EnumOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// EnumPropertyOptions: Options for enum properties, which allow you to -// define a restricted set of strings to match user queries, set +// EnumPropertyOptions: The options for enum properties, which allow you +// to define a restricted set of strings to match user queries, set // rankings for those string values, and define an operator name to be // paired with those strings so that users can narrow results to only // items with a specific value. For example, for items in a request @@ -2310,7 +2310,7 @@ type FacetOptions struct { // used to compute facets. ObjectType string `json:"objectType,omitempty"` - // OperatorName: Name of the operator chosen for faceting. @see + // OperatorName: The name of the operator chosen for faceting. @see // cloudsearch.SchemaPropertyOptions OperatorName string `json:"operatorName,omitempty"` @@ -2352,7 +2352,7 @@ type FacetResult struct { // empty. ObjectType string `json:"objectType,omitempty"` - // OperatorName: Name of the operator chosen for faceting. @see + // OperatorName: The name of the operator chosen for faceting. @see // cloudsearch.SchemaPropertyOptions OperatorName string `json:"operatorName,omitempty"` @@ -2384,7 +2384,7 @@ func (s *FacetResult) MarshalJSON() ([]byte, error) { } type FieldViolation struct { - // Description: Description of the error. + // Description: The description of the error. Description string `json:"description,omitempty"` // Field: Path of field with violation. @@ -3068,7 +3068,7 @@ func (s *HtmlOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// HtmlPropertyOptions: Options for html properties. +// HtmlPropertyOptions: The options for html properties. type HtmlPropertyOptions struct { // OperatorOptions: If set, describes how the property should be used as // a search operator. @@ -3212,7 +3212,7 @@ func (s *IndexItemOptions) MarshalJSON() ([]byte, error) { } type IndexItemRequest struct { - // ConnectorName: Name of connector making this call. Format: + // ConnectorName: The name of connector making this call. Format: // datasources/{source_id}/connectors/{ID} ConnectorName string `json:"connectorName,omitempty"` @@ -3221,15 +3221,15 @@ type IndexItemRequest struct { IndexItemOptions *IndexItemOptions `json:"indexItemOptions,omitempty"` - // Item: Name of the item. Format: + // Item: The name of the item. Format: // datasources/{source_id}/items/{item_id} Item *Item `json:"item,omitempty"` // Mode: Required. The RequestMode for this request. // // Possible values: - // "UNSPECIFIED" - Priority is not specified in the update request. - // Leaving priority unspecified results in an update failure. + // "UNSPECIFIED" - The priority is not specified in the update + // request. Leaving priority unspecified results in an update failure. // "SYNCHRONOUS" - For real-time updates. // "ASYNCHRONOUS" - For changes that are executed after the response // is sent back to the caller. @@ -3323,7 +3323,7 @@ func (s *IntegerOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// IntegerPropertyOptions: Options for integer properties. +// IntegerPropertyOptions: The options for integer properties. type IntegerPropertyOptions struct { // MaximumValue: The maximum value of the property. The minimum and // maximum values for the property are used to rank results according to @@ -3454,7 +3454,7 @@ type Item struct { // Content: Item content to be indexed and made text searchable. Content *ItemContent `json:"content,omitempty"` - // ItemType: Type for this item. + // ItemType: The type for this item. // // Possible values: // "UNSPECIFIED" @@ -3467,10 +3467,10 @@ type Item struct { // otherwise has the same purpose as CONTAINER_ITEM. ItemType string `json:"itemType,omitempty"` - // Metadata: Metadata information. + // Metadata: The metadata information. Metadata *ItemMetadata `json:"metadata,omitempty"` - // Name: Name of the Item. Format: + // Name: The name of the Item. Format: // datasources/{source_id}/items/{item_id} This is a required field. The // maximum length is 1536 characters. Name string `json:"name,omitempty"` @@ -3529,7 +3529,8 @@ func (s *Item) MarshalJSON() ([]byte, error) { } // ItemAcl: Access control list information for the item. For more -// information see Map ACLs (/cloud-search/docs/guides/acls). +// information see Map ACLs +// (https://developers.google.com/cloud-search/docs/guides/acls). type ItemAcl struct { // AclInheritanceType: Sets the type of access rules to apply when an // item inherits its ACL from a parent. This should always be set in @@ -3556,7 +3557,7 @@ type ItemAcl struct { // list allowed readers. The maximum number of elements is 100. DeniedReaders []*Principal `json:"deniedReaders,omitempty"` - // InheritAclFrom: Name of the item to inherit the Access Permission + // InheritAclFrom: The name of the item to inherit the Access Permission // List (ACL) from. Note: ACL inheritance *only* provides access // permissions to child items and does not define structural // relationships, nor does it provide convenient ways to delete large @@ -4270,8 +4271,8 @@ func (s *Metaline) MarshalJSON() ([]byte, error) { // Name: A person's name. type Name struct { // DisplayName: The read-only display name formatted according to the - // locale specified by the viewer's account or the Accept-Language HTTP - // header. + // locale specified by the viewer's account or the `Accept-Language` + // HTTP header. DisplayName string `json:"displayName,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -4350,13 +4351,13 @@ func (s *NamedProperty) MarshalJSON() ([]byte, error) { // ObjectDefinition: The definition for an object within a data source. type ObjectDefinition struct { - // Name: Name for the object, which then defines its type. Item indexing - // requests should set the objectType field equal to this value. For - // example, if *name* is *Document*, then indexing requests for items of - // type Document should set objectType equal to *Document*. Each object - // definition must be uniquely named within a schema. The name must - // start with a letter and can only contain letters (A-Z, a-z) or - // numbers (0-9). The maximum length is 256 characters. + // Name: The name for the object, which then defines its type. Item + // indexing requests should set the objectType field equal to this + // value. For example, if *name* is *Document*, then indexing requests + // for items of type Document should set objectType equal to *Document*. + // Each object definition must be uniquely named within a schema. The + // name must start with a letter and can only contain letters (A-Z, a-z) + // or numbers (0-9). The maximum length is 256 characters. Name string `json:"name,omitempty"` // Options: The optional object-specific options. @@ -4431,8 +4432,8 @@ func (s *ObjectDisplayOptions) MarshalJSON() ([]byte, error) { // ObjectOptions: The options for an object. type ObjectOptions struct { - // DisplayOptions: Options that determine how the object is displayed in - // the Cloud Search results page. + // DisplayOptions: The options that determine how the object is + // displayed in the Cloud Search results page. DisplayOptions *ObjectDisplayOptions `json:"displayOptions,omitempty"` // FreshnessOptions: The freshness options for an object. @@ -4462,7 +4463,7 @@ func (s *ObjectOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ObjectPropertyOptions: Options for object properties. +// ObjectPropertyOptions: The options for object properties. type ObjectPropertyOptions struct { // SubobjectProperties: The properties of the sub-object. These // properties represent a nested object. For example, if this property @@ -4620,7 +4621,9 @@ type Person struct { EmailAddresses []*EmailAddress `json:"emailAddresses,omitempty"` // Name: The resource name of the person to provide information about. - // See People.get from Google People API. + // See `People.get` + // (https://developers.google.com/people/api/rest/v1/people/get) from + // the Google People API. Name string `json:"name,omitempty"` // ObfuscatedId: Obfuscated ID of a person. @@ -4686,7 +4689,7 @@ func (s *Photo) MarshalJSON() ([]byte, error) { } type PollItemsRequest struct { - // ConnectorName: Name of connector making this call. Format: + // ConnectorName: The name of connector making this call. Format: // datasources/{source_id}/connectors/{ID} ConnectorName string `json:"connectorName,omitempty"` @@ -4829,7 +4832,7 @@ type ProcessingError struct { // "ACL_CYCLE" - ACL inheritance graph formed a cycle. Code string `json:"code,omitempty"` - // ErrorMessage: Description of the error. + // ErrorMessage: The description of the error. ErrorMessage string `json:"errorMessage,omitempty"` // FieldViolations: In case the item fields are invalid, this field @@ -4865,9 +4868,9 @@ type PropertyDefinition struct { DatePropertyOptions *DatePropertyOptions `json:"datePropertyOptions,omitempty"` - // DisplayOptions: Options that determine how the property is displayed - // in the Cloud Search results page if it is specified to be displayed - // in the object's display options . + // DisplayOptions: The options that determine how the property is + // displayed in the Cloud Search results page if it's specified to be + // displayed in the object's display options. DisplayOptions *PropertyDisplayOptions `json:"displayOptions,omitempty"` DoublePropertyOptions *DoublePropertyOptions `json:"doublePropertyOptions,omitempty"` @@ -4881,7 +4884,7 @@ type PropertyDefinition struct { // IsFacetable: Indicates that the property can be used for generating // facets. Cannot be true for properties whose type is object. // IsReturnable must be true to set this option. Only supported for - // Boolean, Enum, and Text properties. + // boolean, enum, and text properties. IsFacetable bool `json:"isFacetable,omitempty"` // IsRepeatable: Indicates that multiple values are allowed for the @@ -4904,8 +4907,8 @@ type PropertyDefinition struct { // IsSortable: Indicates that the property can be used for sorting. // Cannot be true for properties that are repeatable. Cannot be true for // properties whose type is object. IsReturnable must be true to set - // this option. Only supported for Boolean, Date, Double, Integer, and - // Timestamp properties. + // this option. Only supported for boolean, date, double, integer, and + // timestamp properties. IsSortable bool `json:"isSortable,omitempty"` // IsSuggestable: Indicates that the property can be used for generating @@ -5005,10 +5008,10 @@ type PushItem struct { // error. The maximum length is 2048 characters. ContentHash string `json:"contentHash,omitempty"` - // MetadataHash: Metadata hash of the item according to the repository. - // If specified, this is used to determine how to modify this item's - // status. Setting this field and the type field results in argument - // error. The maximum length is 2048 characters. + // MetadataHash: The metadata hash of the item according to the + // repository. If specified, this is used to determine how to modify + // this item's status. Setting this field and the type field results in + // argument error. The maximum length is 2048 characters. MetadataHash string `json:"metadataHash,omitempty"` // Payload: Provides additional document state information for the @@ -5016,7 +5019,7 @@ type PushItem struct { // maximum length is 8192 bytes. Payload string `json:"payload,omitempty"` - // Queue: Queue to which this item belongs to. The default queue is + // Queue: Queue to which this item belongs. The `default` queue is // chosen if this field is not specified. The maximum length is 512 // characters. Queue string `json:"queue,omitempty"` @@ -5077,7 +5080,7 @@ func (s *PushItem) MarshalJSON() ([]byte, error) { } type PushItemRequest struct { - // ConnectorName: Name of connector making this call. Format: + // ConnectorName: The name of connector making this call. Format: // datasources/{source_id}/connectors/{ID} ConnectorName string `json:"connectorName,omitempty"` @@ -5349,15 +5352,15 @@ type QueryOperator struct { // isolate the property using the less-than operator. LessThanOperatorName string `json:"lessThanOperatorName,omitempty"` - // ObjectType: Name of the object corresponding to the operator. This - // field is only filled for schema-specific operators, and is unset for - // common operators. + // ObjectType: The name of the object corresponding to the operator. + // This field is only filled for schema-specific operators, and is unset + // for common operators. ObjectType string `json:"objectType,omitempty"` // OperatorName: The name of the operator. OperatorName string `json:"operatorName,omitempty"` - // Type: Type of the operator. + // Type: The type of the operator. // // Possible values: // "UNKNOWN" - Invalid value. @@ -5407,7 +5410,7 @@ type QuerySource struct { // used with the 'source' operator. ShortName string `json:"shortName,omitempty"` - // Source: Name of the source + // Source: The name of the source Source *Source `json:"source,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -5450,7 +5453,7 @@ type RepositoryError struct { // codes. HttpStatusCode int64 `json:"httpStatusCode,omitempty"` - // Type: Type of error. + // Type: The type of error. // // Possible values: // "UNKNOWN" - Unknown error. @@ -5929,7 +5932,7 @@ type SearchApplication struct { // requests made for the search application in query APIs. EnableAuditLog bool `json:"enableAuditLog,omitempty"` - // Name: Name of the Search Application. Format: + // Name: The name of the Search Application. Format: // searchapplications/{application_id}. Name string `json:"name,omitempty"` @@ -5984,8 +5987,8 @@ func (s *SearchApplication) MarshalJSON() ([]byte, error) { // SearchApplicationQueryStats: Search application level query stats per // date type SearchApplicationQueryStats struct { - // Date: Date for which query stats were calculated. Stats calculated on - // the next day close to midnight are returned. + // Date: The date for which query stats were calculated. Stats + // calculated on the next day close to midnight are returned. Date *Date `json:"date,omitempty"` QueryCountByStatus []*QueryCountByStatus `json:"queryCountByStatus,omitempty"` @@ -6014,7 +6017,7 @@ func (s *SearchApplicationQueryStats) MarshalJSON() ([]byte, error) { } type SearchApplicationSessionStats struct { - // Date: Date for which session stats were calculated. Stats are + // Date: The date for which session stats were calculated. Stats are // calculated on the following day, close to midnight PST, and then // returned. Date *Date `json:"date,omitempty"` @@ -6046,8 +6049,8 @@ func (s *SearchApplicationSessionStats) MarshalJSON() ([]byte, error) { } type SearchApplicationUserStats struct { - // Date: Date for which session stats were calculated. Stats calculated - // on the next day close to midnight are returned. + // Date: The date for which session stats were calculated. Stats + // calculated on the next day close to midnight are returned. Date *Date `json:"date,omitempty"` // OneDayActiveUsersCount: The count of unique active users in the past @@ -6448,8 +6451,8 @@ func (s *Snippet) MarshalJSON() ([]byte, error) { } type SortOptions struct { - // OperatorName: Name of the operator corresponding to the field to sort - // on. The corresponding property must be marked as sortable. + // OperatorName: The name of the operator corresponding to the field to + // sort on. The corresponding property must be marked as sortable. OperatorName string `json:"operatorName,omitempty"` // SortOrder: Ascending is the default sort order @@ -6796,7 +6799,7 @@ func (s *SpellResult) MarshalJSON() ([]byte, error) { // StartUploadItemRequest: Start upload file request. type StartUploadItemRequest struct { - // ConnectorName: Name of connector making this call. Format: + // ConnectorName: The name of connector making this call. Format: // datasources/{source_id}/connectors/{ID} ConnectorName string `json:"connectorName,omitempty"` @@ -7055,7 +7058,7 @@ type TextOperatorOptions struct { // atomic value in operator searches and facet matches. For example, if // the operator name is "genre" and the value is "science-fiction" the // query restrictions "genre:science" and "genre:fiction" doesn't match - // the item; "genre:science-fiction" does. Value matching is + // the item; "genre:science-fiction" does. Text value matching is // case-sensitive and does not remove special characters. If false, the // text is tokenized. For example, if the value is "science-fiction" the // queries "genre:science" and "genre:fiction" matches the item. @@ -7097,7 +7100,7 @@ func (s *TextOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TextPropertyOptions: Options for text properties. +// TextPropertyOptions: The options for text properties. type TextPropertyOptions struct { // OperatorOptions: If set, describes how the property should be used as // a search operator. @@ -7221,7 +7224,7 @@ func (s *TimestampOperatorOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TimestampPropertyOptions: Options for timestamp properties. +// TimestampPropertyOptions: The options for timestamp properties. type TimestampPropertyOptions struct { // OperatorOptions: If set, describes how the timestamp should be used // as a search operator. @@ -7354,14 +7357,14 @@ func (s *UnmappedIdentity) MarshalJSON() ([]byte, error) { } type UnreserveItemsRequest struct { - // ConnectorName: Name of connector making this call. Format: + // ConnectorName: The name of connector making this call. Format: // datasources/{source_id}/connectors/{ID} ConnectorName string `json:"connectorName,omitempty"` // DebugOptions: Common debug options. DebugOptions *DebugOptions `json:"debugOptions,omitempty"` - // Queue: Name of a queue to unreserve items from. + // Queue: The name of a queue to unreserve items from. Queue string `json:"queue,omitempty"` // ForceSendFields is a list of field names (e.g. "ConnectorName") to @@ -7455,7 +7458,7 @@ func (s *UpdateSchemaRequest) MarshalJSON() ([]byte, error) { // after its creation. Updating of item content may refer to this // uploaded content via contentDataRef. type UploadItemRef struct { - // Name: Name of the content reference. The maximum length is 2048 + // Name: The name of the content reference. The maximum length is 2048 // characters. Name string `json:"name,omitempty"` @@ -8724,7 +8727,7 @@ type IndexingDatasourcesDeleteSchemaCall struct { // DeleteSchema: Deletes the schema of a data source. **Note:** This API // requires an admin or service account to execute. // -// - name: Name of the data source to delete Schema. Format: +// - name: The name of the data source to delete Schema. Format: // datasources/{source_id}. func (r *IndexingDatasourcesService) DeleteSchema(name string) *IndexingDatasourcesDeleteSchemaCall { c := &IndexingDatasourcesDeleteSchemaCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -8840,7 +8843,7 @@ func (c *IndexingDatasourcesDeleteSchemaCall) Do(opts ...googleapi.CallOption) ( // "type": "boolean" // }, // "name": { - // "description": "Name of the data source to delete Schema. Format: datasources/{source_id}", + // "description": "The name of the data source to delete Schema. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -8874,7 +8877,7 @@ type IndexingDatasourcesGetSchemaCall struct { // GetSchema: Gets the schema of a data source. **Note:** This API // requires an admin or service account to execute. // -// - name: Name of the data source to get Schema. Format: +// - name: The name of the data source to get Schema. Format: // datasources/{source_id}. func (r *IndexingDatasourcesService) GetSchema(name string) *IndexingDatasourcesGetSchemaCall { c := &IndexingDatasourcesGetSchemaCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9003,7 +9006,7 @@ func (c *IndexingDatasourcesGetSchemaCall) Do(opts ...googleapi.CallOption) (*Sc // "type": "boolean" // }, // "name": { - // "description": "Name of the data source to get Schema. Format: datasources/{source_id}", + // "description": "The name of the data source to get Schema. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -9039,7 +9042,7 @@ type IndexingDatasourcesUpdateSchemaCall struct { // updates the schema by overwriting the entire schema. **Note:** This // API requires an admin or service account to execute. // -// - name: Name of the data source to update Schema. Format: +// - name: The name of the data source to update Schema. Format: // datasources/{source_id}. func (r *IndexingDatasourcesService) UpdateSchema(name string, updateschemarequest *UpdateSchemaRequest) *IndexingDatasourcesUpdateSchemaCall { c := &IndexingDatasourcesUpdateSchemaCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9148,7 +9151,7 @@ func (c *IndexingDatasourcesUpdateSchemaCall) Do(opts ...googleapi.CallOption) ( // ], // "parameters": { // "name": { - // "description": "Name of the data source to update Schema. Format: datasources/{source_id}", + // "description": "The name of the data source to update Schema. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -9185,7 +9188,7 @@ type IndexingDatasourcesItemsDeleteCall struct { // API requires an admin or service account to execute. The service // account used is the one whitelisted in the corresponding data source. // -// - name: Name of the item to delete. Format: +// - name: The name of the item to delete. Format: // datasources/{source_id}/items/{item_id}. func (r *IndexingDatasourcesItemsService) Delete(name string) *IndexingDatasourcesItemsDeleteCall { c := &IndexingDatasourcesItemsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9193,8 +9196,8 @@ func (r *IndexingDatasourcesItemsService) Delete(name string) *IndexingDatasourc return c } -// ConnectorName sets the optional parameter "connectorName": Name of -// connector making this call. Format: +// ConnectorName sets the optional parameter "connectorName": The name +// of connector making this call. Format: // datasources/{source_id}/connectors/{ID} func (c *IndexingDatasourcesItemsDeleteCall) ConnectorName(connectorName string) *IndexingDatasourcesItemsDeleteCall { c.urlParams_.Set("connectorName", connectorName) @@ -9213,8 +9216,8 @@ func (c *IndexingDatasourcesItemsDeleteCall) DebugOptionsEnableDebugging(debugOp // for this request. // // Possible values: -// "UNSPECIFIED" - Priority is not specified in the update request. -// Leaving priority unspecified results in an update failure. +// "UNSPECIFIED" - The priority is not specified in the update +// request. Leaving priority unspecified results in an update failure. // "SYNCHRONOUS" - For real-time updates. // "ASYNCHRONOUS" - For changes that are executed after the response // is sent back to the caller. @@ -9334,7 +9337,7 @@ func (c *IndexingDatasourcesItemsDeleteCall) Do(opts ...googleapi.CallOption) (* // ], // "parameters": { // "connectorName": { - // "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + // "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", // "location": "query", // "type": "string" // }, @@ -9351,7 +9354,7 @@ func (c *IndexingDatasourcesItemsDeleteCall) Do(opts ...googleapi.CallOption) (* // "ASYNCHRONOUS" // ], // "enumDescriptions": [ - // "Priority is not specified in the update request. Leaving priority unspecified results in an update failure.", + // "The priority is not specified in the update request. Leaving priority unspecified results in an update failure.", // "For real-time updates.", // "For changes that are executed after the response is sent back to the caller." // ], @@ -9359,7 +9362,7 @@ func (c *IndexingDatasourcesItemsDeleteCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "name": { - // "description": "Required. Name of the item to delete. Format: datasources/{source_id}/items/{item_id}", + // "description": "Required. The name of the item to delete. Format: datasources/{source_id}/items/{item_id}", // "location": "path", // "pattern": "^datasources/[^/]+/items/[^/]+$", // "required": true, @@ -9400,8 +9403,8 @@ type IndexingDatasourcesItemsDeleteQueueItemsCall struct { // account to execute. The service account used is the one whitelisted // in the corresponding data source. // -// - name: Name of the Data Source to delete items in a queue. Format: -// datasources/{source_id}. +// - name: The name of the Data Source to delete items in a queue. +// Format: datasources/{source_id}. func (r *IndexingDatasourcesItemsService) DeleteQueueItems(name string, deletequeueitemsrequest *DeleteQueueItemsRequest) *IndexingDatasourcesItemsDeleteQueueItemsCall { c := &IndexingDatasourcesItemsDeleteQueueItemsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9509,7 +9512,7 @@ func (c *IndexingDatasourcesItemsDeleteQueueItemsCall) Do(opts ...googleapi.Call // ], // "parameters": { // "name": { - // "description": "Name of the Data Source to delete items in a queue. Format: datasources/{source_id}", + // "description": "The name of the Data Source to delete items in a queue. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -9546,7 +9549,7 @@ type IndexingDatasourcesItemsGetCall struct { // service account to execute. The service account used is the one // whitelisted in the corresponding data source. // -// - name: Name of the item to get info. Format: +// - name: The name of the item to get info. Format: // datasources/{source_id}/items/{item_id}. func (r *IndexingDatasourcesItemsService) Get(name string) *IndexingDatasourcesItemsGetCall { c := &IndexingDatasourcesItemsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9554,8 +9557,8 @@ func (r *IndexingDatasourcesItemsService) Get(name string) *IndexingDatasourcesI return c } -// ConnectorName sets the optional parameter "connectorName": Name of -// connector making this call. Format: +// ConnectorName sets the optional parameter "connectorName": The name +// of connector making this call. Format: // datasources/{source_id}/connectors/{ID} func (c *IndexingDatasourcesItemsGetCall) ConnectorName(connectorName string) *IndexingDatasourcesItemsGetCall { c.urlParams_.Set("connectorName", connectorName) @@ -9678,7 +9681,7 @@ func (c *IndexingDatasourcesItemsGetCall) Do(opts ...googleapi.CallOption) (*Ite // ], // "parameters": { // "connectorName": { - // "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + // "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", // "location": "query", // "type": "string" // }, @@ -9688,7 +9691,7 @@ func (c *IndexingDatasourcesItemsGetCall) Do(opts ...googleapi.CallOption) (*Ite // "type": "boolean" // }, // "name": { - // "description": "Name of the item to get info. Format: datasources/{source_id}/items/{item_id}", + // "description": "The name of the item to get info. Format: datasources/{source_id}/items/{item_id}", // "location": "path", // "pattern": "^datasources/[^/]+/items/[^/]+$", // "required": true, @@ -9725,7 +9728,7 @@ type IndexingDatasourcesItemsIndexCall struct { // execute. The service account used is the one whitelisted in the // corresponding data source. // -// - name: Name of the Item. Format: +// - name: The name of the Item. Format: // datasources/{source_id}/items/{item_id} This is a required field. // The maximum length is 1536 characters. func (r *IndexingDatasourcesItemsService) Index(name string, indexitemrequest *IndexItemRequest) *IndexingDatasourcesItemsIndexCall { @@ -9835,7 +9838,7 @@ func (c *IndexingDatasourcesItemsIndexCall) Do(opts ...googleapi.CallOption) (*O // ], // "parameters": { // "name": { - // "description": "Name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.", + // "description": "The name of the Item. Format: datasources/{source_id}/items/{item_id} This is a required field. The maximum length is 1536 characters.", // "location": "path", // "pattern": "^datasources/[^/]+/items/[^/]+$", // "required": true, @@ -9872,7 +9875,7 @@ type IndexingDatasourcesItemsListCall struct { // admin or service account to execute. The service account used is the // one whitelisted in the corresponding data source. // -// - name: Name of the Data Source to list Items. Format: +// - name: The name of the Data Source to list Items. Format: // datasources/{source_id}. func (r *IndexingDatasourcesItemsService) List(name string) *IndexingDatasourcesItemsListCall { c := &IndexingDatasourcesItemsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9893,8 +9896,8 @@ func (c *IndexingDatasourcesItemsListCall) Brief(brief bool) *IndexingDatasource return c } -// ConnectorName sets the optional parameter "connectorName": Name of -// connector making this call. Format: +// ConnectorName sets the optional parameter "connectorName": The name +// of connector making this call. Format: // datasources/{source_id}/connectors/{ID} func (c *IndexingDatasourcesItemsListCall) ConnectorName(connectorName string) *IndexingDatasourcesItemsListCall { c.urlParams_.Set("connectorName", connectorName) @@ -10037,7 +10040,7 @@ func (c *IndexingDatasourcesItemsListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "boolean" // }, // "connectorName": { - // "description": "Name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", + // "description": "The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}", // "location": "query", // "type": "string" // }, @@ -10047,7 +10050,7 @@ func (c *IndexingDatasourcesItemsListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "boolean" // }, // "name": { - // "description": "Name of the Data Source to list Items. Format: datasources/{source_id}", + // "description": "The name of the Data Source to list Items. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -10122,7 +10125,7 @@ type IndexingDatasourcesItemsPollCall struct { // service account used is the one whitelisted in the corresponding data // source. // -// - name: Name of the Data Source to poll items. Format: +// - name: The name of the Data Source to poll items. Format: // datasources/{source_id}. func (r *IndexingDatasourcesItemsService) Poll(name string, pollitemsrequest *PollItemsRequest) *IndexingDatasourcesItemsPollCall { c := &IndexingDatasourcesItemsPollCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -10231,7 +10234,7 @@ func (c *IndexingDatasourcesItemsPollCall) Do(opts ...googleapi.CallOption) (*Po // ], // "parameters": { // "name": { - // "description": "Name of the Data Source to poll items. Format: datasources/{source_id}", + // "description": "The name of the Data Source to poll items. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -10268,7 +10271,7 @@ type IndexingDatasourcesItemsPushCall struct { // This API requires an admin or service account to execute. The service // account used is the one whitelisted in the corresponding data source. // -// - name: Name of the item to push into the indexing queue. Format: +// - name: The name of the item to push into the indexing queue. Format: // datasources/{source_id}/items/{ID} This is a required field. The // maximum length is 1536 characters. func (r *IndexingDatasourcesItemsService) Push(name string, pushitemrequest *PushItemRequest) *IndexingDatasourcesItemsPushCall { @@ -10378,7 +10381,7 @@ func (c *IndexingDatasourcesItemsPushCall) Do(opts ...googleapi.CallOption) (*It // ], // "parameters": { // "name": { - // "description": "Name of the item to push into the indexing queue. Format: datasources/{source_id}/items/{ID} This is a required field. The maximum length is 1536 characters.", + // "description": "The name of the item to push into the indexing queue. Format: datasources/{source_id}/items/{ID} This is a required field. The maximum length is 1536 characters.", // "location": "path", // "pattern": "^datasources/[^/]+/items/[^/]+$", // "required": true, @@ -10417,7 +10420,7 @@ type IndexingDatasourcesItemsUnreserveCall struct { // requires an admin or service account to execute. The service account // used is the one whitelisted in the corresponding data source. // -// - name: Name of the Data Source to unreserve all items. Format: +// - name: The name of the Data Source to unreserve all items. Format: // datasources/{source_id}. func (r *IndexingDatasourcesItemsService) Unreserve(name string, unreserveitemsrequest *UnreserveItemsRequest) *IndexingDatasourcesItemsUnreserveCall { c := &IndexingDatasourcesItemsUnreserveCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -10526,7 +10529,7 @@ func (c *IndexingDatasourcesItemsUnreserveCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "name": { - // "description": "Name of the Data Source to unreserve all items. Format: datasources/{source_id}", + // "description": "The name of the Data Source to unreserve all items. Format: datasources/{source_id}", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -10565,7 +10568,7 @@ type IndexingDatasourcesItemsUploadCall struct { // account to execute. The service account used is the one whitelisted // in the corresponding data source. // -// - name: Name of the Item to start a resumable upload. Format: +// - name: The name of the Item to start a resumable upload. Format: // datasources/{source_id}/items/{item_id}. The maximum length is 1536 // bytes. func (r *IndexingDatasourcesItemsService) Upload(name string, startuploaditemrequest *StartUploadItemRequest) *IndexingDatasourcesItemsUploadCall { @@ -10675,7 +10678,7 @@ func (c *IndexingDatasourcesItemsUploadCall) Do(opts ...googleapi.CallOption) (* // ], // "parameters": { // "name": { - // "description": "Name of the Item to start a resumable upload. Format: datasources/{source_id}/items/{item_id}. The maximum length is 1536 bytes.", + // "description": "The name of the Item to start a resumable upload. Format: datasources/{source_id}/items/{item_id}. The maximum length is 1536 bytes.", // "location": "path", // "pattern": "^datasources/[^/]+/items/[^/]+$", // "required": true, @@ -12226,7 +12229,7 @@ type SettingsDatasourcesDeleteCall struct { // Delete: Deletes a datasource. **Note:** This API requires an admin // account to execute. // -// - name: Name of the datasource. Format: datasources/{source_id}. +// - name: The name of the datasource. Format: datasources/{source_id}. func (r *SettingsDatasourcesService) Delete(name string) *SettingsDatasourcesDeleteCall { c := &SettingsDatasourcesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12341,7 +12344,7 @@ func (c *SettingsDatasourcesDeleteCall) Do(opts ...googleapi.CallOption) (*Opera // "type": "boolean" // }, // "name": { - // "description": "Name of the datasource. Format: datasources/{source_id}.", + // "description": "The name of the datasource. Format: datasources/{source_id}.", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -12375,7 +12378,7 @@ type SettingsDatasourcesGetCall struct { // Get: Gets a datasource. **Note:** This API requires an admin account // to execute. // -// - name: Name of the datasource resource. Format: +// - name: The name of the datasource resource. Format: // datasources/{source_id}. func (r *SettingsDatasourcesService) Get(name string) *SettingsDatasourcesGetCall { c := &SettingsDatasourcesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -12504,7 +12507,7 @@ func (c *SettingsDatasourcesGetCall) Do(opts ...googleapi.CallOption) (*DataSour // "type": "boolean" // }, // "name": { - // "description": "Name of the datasource resource. Format: datasources/{source_id}.", + // "description": "The name of the datasource resource. Format: datasources/{source_id}.", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -12731,7 +12734,7 @@ type SettingsDatasourcesUpdateCall struct { // Update: Updates a datasource. **Note:** This API requires an admin // account to execute. // -// - name: Name of the datasource resource. Format: +// - name: The name of the datasource resource. Format: // datasources/{source_id}. The name is ignored when creating a // datasource. func (r *SettingsDatasourcesService) Update(name string, updatedatasourcerequest *UpdateDataSourceRequest) *SettingsDatasourcesUpdateCall { @@ -12841,7 +12844,7 @@ func (c *SettingsDatasourcesUpdateCall) Do(opts ...googleapi.CallOption) (*Opera // ], // "parameters": { // "name": { - // "description": "Name of the datasource resource. Format: datasources/{source_id}. The name is ignored when creating a datasource.", + // "description": "The name of the datasource resource. Format: datasources/{source_id}. The name is ignored when creating a datasource.", // "location": "path", // "pattern": "^datasources/[^/]+$", // "required": true, @@ -13155,7 +13158,7 @@ type SettingsSearchapplicationsGetCall struct { // Get: Gets the specified search application. **Note:** This API // requires an admin account to execute. // -// - name: Name of the search application. Format: +// - name: The name of the search application. Format: // searchapplications/{application_id}. func (r *SettingsSearchapplicationsService) Get(name string) *SettingsSearchapplicationsGetCall { c := &SettingsSearchapplicationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -13284,7 +13287,7 @@ func (c *SettingsSearchapplicationsGetCall) Do(opts ...googleapi.CallOption) (*S // "type": "boolean" // }, // "name": { - // "description": "Name of the search application. Format: searchapplications/{application_id}.", + // "description": "The name of the search application. Format: searchapplications/{application_id}.", // "location": "path", // "pattern": "^searchapplications/[^/]+$", // "required": true, @@ -13658,7 +13661,7 @@ type SettingsSearchapplicationsUpdateCall struct { // Update: Updates a search application. **Note:** This API requires an // admin account to execute. // -// - name: Name of the Search Application. Format: +// - name: The name of the Search Application. Format: // searchapplications/{application_id}. func (r *SettingsSearchapplicationsService) Update(name string, searchapplication *SearchApplication) *SettingsSearchapplicationsUpdateCall { c := &SettingsSearchapplicationsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -13767,7 +13770,7 @@ func (c *SettingsSearchapplicationsUpdateCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "name": { - // "description": "Name of the Search Application. Format: searchapplications/{application_id}.", + // "description": "The name of the Search Application. Format: searchapplications/{application_id}.", // "location": "path", // "pattern": "^searchapplications/[^/]+$", // "required": true, diff --git a/datafusion/v1beta1/datafusion-api.json b/datafusion/v1beta1/datafusion-api.json index 04c701b4308..0f1ad00dfdd 100644 --- a/datafusion/v1beta1/datafusion-api.json +++ b/datafusion/v1beta1/datafusion-api.json @@ -935,7 +935,7 @@ } } }, - "revision": "20220504", + "revision": "20220603", "rootUrl": "https://datafusion.googleapis.com/", "schemas": { "Accelerator": { @@ -1079,6 +1079,21 @@ "properties": {}, "type": "object" }, + "EventPublishConfig": { + "description": "Confirguration of PubSubEventWriter.", + "id": "EventPublishConfig", + "properties": { + "enabled": { + "description": "Required. Option to enable Event Publishing.", + "type": "boolean" + }, + "topic": { + "description": "Required. The resource name of the Pub/Sub topic. Format: projects/{project_id}/topics/{topic_id}", + "type": "string" + } + }, + "type": "object" + }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -1190,6 +1205,10 @@ "description": "Option to enable Stackdriver Monitoring.", "type": "boolean" }, + "eventPublishConfig": { + "$ref": "EventPublishConfig", + "description": "Option to enable and pass metadata for event publishing." + }, "gcsBucket": { "description": "Output only. Cloud Storage bucket generated by Data Fusion in the customer project.", "readOnly": true, diff --git a/datafusion/v1beta1/datafusion-gen.go b/datafusion/v1beta1/datafusion-gen.go index 272d9636bc7..987a970950b 100644 --- a/datafusion/v1beta1/datafusion-gen.go +++ b/datafusion/v1beta1/datafusion-gen.go @@ -520,6 +520,38 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } +// EventPublishConfig: Confirguration of PubSubEventWriter. +type EventPublishConfig struct { + // Enabled: Required. Option to enable Event Publishing. + Enabled bool `json:"enabled,omitempty"` + + // Topic: Required. The resource name of the Pub/Sub topic. Format: + // projects/{project_id}/topics/{topic_id} + Topic string `json:"topic,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") 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. "Enabled") 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 *EventPublishConfig) MarshalJSON() ([]byte, error) { + type NoMethod EventPublishConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Expr: Represents a textual expression in the Common Expression // Language (CEL) syntax. CEL is a C-like expression language. The // syntax and semantics of CEL are documented at @@ -664,6 +696,10 @@ type Instance struct { // EnableStackdriverMonitoring: Option to enable Stackdriver Monitoring. EnableStackdriverMonitoring bool `json:"enableStackdriverMonitoring,omitempty"` + // EventPublishConfig: Option to enable and pass metadata for event + // publishing. + EventPublishConfig *EventPublishConfig `json:"eventPublishConfig,omitempty"` + // GcsBucket: Output only. Cloud Storage bucket generated by Data Fusion // in the customer project. GcsBucket string `json:"gcsBucket,omitempty"` diff --git a/displayvideo/v1/displayvideo-api.json b/displayvideo/v1/displayvideo-api.json index 80390dcdb9b..e077fabf544 100644 --- a/displayvideo/v1/displayvideo-api.json +++ b/displayvideo/v1/displayvideo-api.json @@ -8146,7 +8146,7 @@ } } }, - "revision": "20220526", + "revision": "20220607", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -13980,7 +13980,7 @@ "id": "HouseholdIncomeAssignedTargetingOptionDetails", "properties": { "householdIncome": { - "description": "Output only. The household income of the audience.", + "description": "The household income of the audience. Output only in v1. Required in v2.", "enum": [ "HOUSEHOLD_INCOME_UNSPECIFIED", "HOUSEHOLD_INCOME_UNKNOWN", @@ -14001,7 +14001,6 @@ "The audience is in the top 11-20% of U.S. household incomes.", "The audience is in the top 10% of U.S. household incomes." ], - "readOnly": true, "type": "string" }, "targetingOptionId": { diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 46021805b58..8f4037d310e 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -9060,7 +9060,8 @@ func (s *GuaranteedOrderStatus) MarshalJSON() ([]byte, error) { // details field of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_HOUSEHOLD_INCOME`. type HouseholdIncomeAssignedTargetingOptionDetails struct { - // HouseholdIncome: Output only. The household income of the audience. + // HouseholdIncome: The household income of the audience. Output only in + // v1. Required in v2. // // Possible values: // "HOUSEHOLD_INCOME_UNSPECIFIED" - Default value when household diff --git a/docs/v1/docs-api.json b/docs/v1/docs-api.json index 6adde883de6..a85d1e3ebc3 100644 --- a/docs/v1/docs-api.json +++ b/docs/v1/docs-api.json @@ -216,7 +216,7 @@ } } }, - "revision": "20220520", + "revision": "20220601", "rootUrl": "https://docs.googleapis.com/", "schemas": { "AutoText": { @@ -2411,7 +2411,7 @@ "type": "string" }, "pageBreakBefore": { - "description": "Whether the current paragraph should always start at the beginning of a page. If unset, the value is inherited from the parent.", + "description": "Whether the current paragraph should always start at the beginning of a page. If unset, the value is inherited from the parent. Attempting to update page_break_before for paragraphs in unsupported regions, including Table, Header, Footer and Footnote can result in an invalid document state in which case a 400 bad request error is returned.", "type": "boolean" }, "shading": { diff --git a/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index 59cbfe3f5ba..21dd09e1a39 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -3953,7 +3953,10 @@ type ParagraphStyle struct { // PageBreakBefore: Whether the current paragraph should always start at // the beginning of a page. If unset, the value is inherited from the - // parent. + // parent. Attempting to update page_break_before for paragraphs in + // unsupported regions, including Table, Header, Footer and Footnote can + // result in an invalid document state in which case a 400 bad request + // error is returned. PageBreakBefore bool `json:"pageBreakBefore,omitempty"` // Shading: The shading of the paragraph. If unset, the value is diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index 4e8fdeaa187..bc46b87c523 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1029,7 +1029,7 @@ } } }, - "revision": "20220513", + "revision": "20220602", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -2150,7 +2150,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1DocumentPageMatrix" }, @@ -2423,10 +2423,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", @@ -3382,7 +3378,7 @@ "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest", "properties": { "defaultProcessorVersion": { - "description": "Required. The resource name of child ProcessorVersion to use as default.", + "description": "Required. The resource name of child ProcessorVersion to use as default. Format: `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{version}`", "type": "string" } }, @@ -3800,7 +3796,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix" }, @@ -4073,10 +4069,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", @@ -5021,7 +5013,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix" }, @@ -5294,10 +5286,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index cc76f3d0d79..fe9dba0cb57 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -2198,8 +2198,8 @@ type GoogleCloudDocumentaiV1DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -2671,12 +2671,6 @@ func (s *GoogleCloudDocumentaiV1DocumentPageLine) MarshalJSON() ([]byte, error) // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -2692,7 +2686,7 @@ type GoogleCloudDocumentaiV1DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -2700,8 +2694,8 @@ type GoogleCloudDocumentaiV1DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. @@ -4324,7 +4318,9 @@ func (s *GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata) MarshalJSON( // message for the set default processor version method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest struct { // DefaultProcessorVersion: Required. The resource name of child - // ProcessorVersion to use as default. + // ProcessorVersion to use as default. Format: + // `projects/{project}/locations/{location}/processors/{processor}/proces + // sorVersions/{version}` DefaultProcessorVersion string `json:"defaultProcessorVersion,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -4907,8 +4903,8 @@ type GoogleCloudDocumentaiV1beta1DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta1DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta1DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -5381,12 +5377,6 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -5402,7 +5392,7 @@ type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -5410,8 +5400,8 @@ type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. @@ -6892,8 +6882,8 @@ type GoogleCloudDocumentaiV1beta2DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta2DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta2DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -7366,12 +7356,6 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -7387,7 +7371,7 @@ type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -7395,8 +7379,8 @@ type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. diff --git a/documentai/v1beta2/documentai-api.json b/documentai/v1beta2/documentai-api.json index aa386ebeedb..67c82ed755b 100644 --- a/documentai/v1beta2/documentai-api.json +++ b/documentai/v1beta2/documentai-api.json @@ -292,7 +292,7 @@ } } }, - "revision": "20220505", + "revision": "20220602", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -1525,7 +1525,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix" }, @@ -1798,10 +1798,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", @@ -2771,7 +2767,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix" }, @@ -3044,10 +3040,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index 8300547bdef..cc683f619b3 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -2321,8 +2321,8 @@ type GoogleCloudDocumentaiV1beta1DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta1DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta1DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -2795,12 +2795,6 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -2816,7 +2810,7 @@ type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -2824,8 +2818,8 @@ type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. @@ -4370,8 +4364,8 @@ type GoogleCloudDocumentaiV1beta2DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta2DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta2DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -4844,12 +4838,6 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -4865,7 +4853,7 @@ type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -4873,8 +4861,8 @@ type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index a55bb78b58d..d68b61eb27b 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -796,7 +796,7 @@ } } }, - "revision": "20220513", + "revision": "20220602", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -2029,7 +2029,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix" }, @@ -2302,10 +2302,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", @@ -3250,7 +3246,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix" }, @@ -3523,10 +3519,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", @@ -4724,7 +4716,7 @@ "type": "array" }, "transforms": { - "description": "Transformation matrices (both already applied and not) to the original document image to produce Page.image.", + "description": "Transformation matrices that were applied to the original document image to produce Page.image.", "items": { "$ref": "GoogleCloudDocumentaiV1beta3DocumentPageMatrix" }, @@ -4997,10 +4989,6 @@ "description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.", "id": "GoogleCloudDocumentaiV1beta3DocumentPageMatrix", "properties": { - "applied": { - "description": "Has the transformation already been applied to the current Document? Needed to disambiguate pre-processing transformations already applied vs transformations added at annotation time by HITL operators.", - "type": "boolean" - }, "cols": { "description": "Number of columns in the matrix.", "format": "int32", @@ -6002,7 +5990,7 @@ "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest", "properties": { "defaultProcessorVersion": { - "description": "Required. The resource name of child ProcessorVersion to use as default.", + "description": "Required. The resource name of child ProcessorVersion to use as default. Format: `projects/{project}/locations/{location}/processors/{processor}/processorVersions/{version}`", "type": "string" } }, diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index a335b9fd6ea..309a477a27d 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -2321,8 +2321,8 @@ type GoogleCloudDocumentaiV1beta1DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta1DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta1DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -2795,12 +2795,6 @@ func (s *GoogleCloudDocumentaiV1beta1DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -2816,7 +2810,7 @@ type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -2824,8 +2818,8 @@ type GoogleCloudDocumentaiV1beta1DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. @@ -4306,8 +4300,8 @@ type GoogleCloudDocumentaiV1beta2DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta2DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta2DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -4780,12 +4774,6 @@ func (s *GoogleCloudDocumentaiV1beta2DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -4801,7 +4789,7 @@ type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -4809,8 +4797,8 @@ type GoogleCloudDocumentaiV1beta2DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. @@ -6717,8 +6705,8 @@ type GoogleCloudDocumentaiV1beta3DocumentPage struct { // Tokens: A list of visually detected tokens on the page. Tokens []*GoogleCloudDocumentaiV1beta3DocumentPageToken `json:"tokens,omitempty"` - // Transforms: Transformation matrices (both already applied and not) to - // the original document image to produce Page.image. + // Transforms: Transformation matrices that were applied to the original + // document image to produce Page.image. Transforms []*GoogleCloudDocumentaiV1beta3DocumentPageMatrix `json:"transforms,omitempty"` // VisualElements: A list of detected non-text visual elements e.g. @@ -7191,12 +7179,6 @@ func (s *GoogleCloudDocumentaiV1beta3DocumentPageLine) MarshalJSON() ([]byte, er // transformation matrix, intended to be compatible and used with OpenCV // format for image manipulation. type GoogleCloudDocumentaiV1beta3DocumentPageMatrix struct { - // Applied: Has the transformation already been applied to the current - // Document? Needed to disambiguate pre-processing transformations - // already applied vs transformations added at annotation time by HITL - // operators. - Applied bool `json:"applied,omitempty"` - // Cols: Number of columns in the matrix. Cols int64 `json:"cols,omitempty"` @@ -7212,7 +7194,7 @@ type GoogleCloudDocumentaiV1beta3DocumentPageMatrix struct { // https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html Type int64 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Applied") to + // ForceSendFields is a list of field names (e.g. "Cols") 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 @@ -7220,8 +7202,8 @@ type GoogleCloudDocumentaiV1beta3DocumentPageMatrix struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Applied") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Cols") 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. @@ -8879,7 +8861,9 @@ func (s *GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata) Marshal // Request message for the set default processor version method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest struct { // DefaultProcessorVersion: Required. The resource name of child - // ProcessorVersion to use as default. + // ProcessorVersion to use as default. Format: + // `projects/{project}/locations/{location}/processors/{processor}/proces + // sorVersions/{version}` DefaultProcessorVersion string `json:"defaultProcessorVersion,omitempty"` // ForceSendFields is a list of field names (e.g. diff --git a/file/v1/file-api.json b/file/v1/file-api.json index 0735b7527aa..c56f3397eda 100644 --- a/file/v1/file-api.json +++ b/file/v1/file-api.json @@ -846,7 +846,7 @@ } } }, - "revision": "20220407", + "revision": "20220530", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -913,8 +913,8 @@ ], "enumDescriptions": [ "Not set.", - "STANDARD tier.", - "PREMIUM tier.", + "STANDARD tier. BASIC_HDD is the preferred term for this tier.", + "PREMIUM tier. BASIC_SSD is the preferred term for this tier.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_HDD is an alias for STANDARD Tier, offering economical performance backed by HDD.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_SSD is an alias for PREMIUM Tier, and offers improved performance backed by SSD.", "HIGH_SCALE instances offer expanded capacity and performance scaling capabilities.", @@ -1432,8 +1432,8 @@ ], "enumDescriptions": [ "Not set.", - "STANDARD tier.", - "PREMIUM tier.", + "STANDARD tier. BASIC_HDD is the preferred term for this tier.", + "PREMIUM tier. BASIC_SSD is the preferred term for this tier.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_HDD is an alias for STANDARD Tier, offering economical performance backed by HDD.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_SSD is an alias for PREMIUM Tier, and offers improved performance backed by SSD.", "HIGH_SCALE instances offer expanded capacity and performance scaling capabilities.", diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index 29d748276cb..b8d44b2faa6 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -250,8 +250,10 @@ type Backup struct { // // Possible values: // "TIER_UNSPECIFIED" - Not set. - // "STANDARD" - STANDARD tier. - // "PREMIUM" - PREMIUM tier. + // "STANDARD" - STANDARD tier. BASIC_HDD is the preferred term for + // this tier. + // "PREMIUM" - PREMIUM tier. BASIC_SSD is the preferred term for this + // tier. // "BASIC_HDD" - BASIC instances offer a maximum capacity of 63.9 TB. // BASIC_HDD is an alias for STANDARD Tier, offering economical // performance backed by HDD. @@ -1016,8 +1018,10 @@ type Instance struct { // // Possible values: // "TIER_UNSPECIFIED" - Not set. - // "STANDARD" - STANDARD tier. - // "PREMIUM" - PREMIUM tier. + // "STANDARD" - STANDARD tier. BASIC_HDD is the preferred term for + // this tier. + // "PREMIUM" - PREMIUM tier. BASIC_SSD is the preferred term for this + // tier. // "BASIC_HDD" - BASIC instances offer a maximum capacity of 63.9 TB. // BASIC_HDD is an alias for STANDARD Tier, offering economical // performance backed by HDD. diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index 91d407dd886..167e0803618 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -905,7 +905,7 @@ } } }, - "revision": "20220505", + "revision": "20220530", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosVMMembershipSpec": { @@ -1011,6 +1011,17 @@ }, "type": "object" }, + "ApplianceCluster": { + "description": "ApplianceCluster contains information specific to GDC Edge Appliance Clusters.", + "id": "ApplianceCluster", + "properties": { + "resourceLink": { + "description": "Immutable. Self-link of the GCP resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", + "type": "string" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1156,6 +1167,10 @@ "$ref": "ConfigManagementGitConfig", "description": "Git repo configuration for the cluster." }, + "oci": { + "$ref": "ConfigManagementOciConfig", + "description": "OCI repo configuration for the cluster" + }, "preventDrift": { "description": "Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", "type": "boolean" @@ -1614,6 +1629,34 @@ }, "type": "object" }, + "ConfigManagementOciConfig": { + "description": "OCI repo configuration for a single cluster", + "id": "ConfigManagementOciConfig", + "properties": { + "gcpServiceAccountEmail": { + "description": "The GCP Service Account Email used for auth when secret_type is gcpServiceAccount.", + "type": "string" + }, + "policyDir": { + "description": "The absolute path of the directory that contains the local resources. Default: the root directory of the image.", + "type": "string" + }, + "secretType": { + "description": "Type of secret configured for access to the Git repo.", + "type": "string" + }, + "syncRepo": { + "description": "The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", + "type": "string" + }, + "syncWaitSecs": { + "description": "Period in seconds between consecutive syncs. Default: 15.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "ConfigManagementOperatorState": { "description": "State information for an ACM's Operator", "id": "ConfigManagementOperatorState", @@ -1672,6 +1715,10 @@ "description": "Logs all denies and dry run failures.", "type": "boolean" }, + "monitoring": { + "$ref": "ConfigManagementPolicyControllerMonitoring", + "description": "Monitoring specifies the configuration of monitoring." + }, "referentialRulesEnabled": { "description": "Enables the ability to use Constraint Templates that reference to objects other than the object currently being evaluated.", "type": "boolean" @@ -1683,6 +1730,30 @@ }, "type": "object" }, + "ConfigManagementPolicyControllerMonitoring": { + "description": "PolicyControllerMonitoring specifies the backends Policy Controller should export metrics to. For example, to specify metrics should be exported to Cloud Monitoring and Prometheus, specify backends: [\"cloudmonitoring\", \"prometheus\"]", + "id": "ConfigManagementPolicyControllerMonitoring", + "properties": { + "backends": { + "description": "Specifies the list of backends Policy Controller will export to. An empty list would effectively disable metrics export.", + "items": { + "enum": [ + "MONITORING_BACKEND_UNSPECIFIED", + "PROMETHEUS", + "CLOUD_MONITORING" + ], + "enumDescriptions": [ + "Backend cannot be determined", + "Prometheus backend for monitoring", + "Stackdriver/Cloud Monitoring backend for monitoring" + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ConfigManagementPolicyControllerState": { "description": "State for PolicyControllerState.", "id": "ConfigManagementPolicyControllerState", @@ -2440,6 +2511,10 @@ "description": "MembershipEndpoint contains information needed to contact a Kubernetes API, endpoint and any additional Kubernetes metadata.", "id": "MembershipEndpoint", "properties": { + "applianceCluster": { + "$ref": "ApplianceCluster", + "description": "Optional. Specific information for a GDC Edge Appliance cluster." + }, "edgeCluster": { "$ref": "EdgeCluster", "description": "Optional. Specific information for a Google Edge cluster." diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index 02fc7ae6032..30cd74528ed 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -387,6 +387,38 @@ func (s *AppDevExperienceFeatureState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ApplianceCluster: ApplianceCluster contains information specific to +// GDC Edge Appliance Clusters. +type ApplianceCluster struct { + // ResourceLink: Immutable. Self-link of the GCP resource for the + // Appliance Cluster. For example: + // //transferappliance.googleapis.com/projects/my-project/locations/us-we + // st1-a/appliances/my-appliance + ResourceLink string `json:"resourceLink,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourceLink") 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. "ResourceLink") 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 *ApplianceCluster) MarshalJSON() ([]byte, error) { + type NoMethod ApplianceCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must @@ -699,6 +731,9 @@ type ConfigManagementConfigSync struct { // Git: Git repo configuration for the cluster. Git *ConfigManagementGitConfig `json:"git,omitempty"` + // Oci: OCI repo configuration for the cluster + Oci *ConfigManagementOciConfig `json:"oci,omitempty"` + // PreventDrift: Set to true to enable the Config Sync admission webhook // to prevent drifts. If set to `false`, disables the Config Sync // admission webhook and does not prevent drifts. @@ -1365,6 +1400,54 @@ func (s *ConfigManagementMembershipState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ConfigManagementOciConfig: OCI repo configuration for a single +// cluster +type ConfigManagementOciConfig struct { + // GcpServiceAccountEmail: The GCP Service Account Email used for auth + // when secret_type is gcpServiceAccount. + GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` + + // PolicyDir: The absolute path of the directory that contains the local + // resources. Default: the root directory of the image. + PolicyDir string `json:"policyDir,omitempty"` + + // SecretType: Type of secret configured for access to the Git repo. + SecretType string `json:"secretType,omitempty"` + + // SyncRepo: The OCI image repository URL for the package to sync from. + // e.g. + // `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`. + SyncRepo string `json:"syncRepo,omitempty"` + + // SyncWaitSecs: Period in seconds between consecutive syncs. Default: + // 15. + SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. + // "GcpServiceAccountEmail") 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. "GcpServiceAccountEmail") + // 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 *ConfigManagementOciConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConfigManagementOciConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ConfigManagementOperatorState: State information for an ACM's // Operator type ConfigManagementOperatorState struct { @@ -1427,6 +1510,9 @@ type ConfigManagementPolicyController struct { // LogDeniesEnabled: Logs all denies and dry run failures. LogDeniesEnabled bool `json:"logDeniesEnabled,omitempty"` + // Monitoring: Monitoring specifies the configuration of monitoring. + Monitoring *ConfigManagementPolicyControllerMonitoring `json:"monitoring,omitempty"` + // ReferentialRulesEnabled: Enables the ability to use Constraint // Templates that reference to objects other than the object currently // being evaluated. @@ -1461,6 +1547,45 @@ func (s *ConfigManagementPolicyController) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ConfigManagementPolicyControllerMonitoring: +// PolicyControllerMonitoring specifies the backends Policy Controller +// should export metrics to. For example, to specify metrics should be +// exported to Cloud Monitoring and Prometheus, specify backends: +// ["cloudmonitoring", "prometheus"] +type ConfigManagementPolicyControllerMonitoring struct { + // Backends: Specifies the list of backends Policy Controller will + // export to. An empty list would effectively disable metrics export. + // + // Possible values: + // "MONITORING_BACKEND_UNSPECIFIED" - Backend cannot be determined + // "PROMETHEUS" - Prometheus backend for monitoring + // "CLOUD_MONITORING" - Stackdriver/Cloud Monitoring backend for + // monitoring + Backends []string `json:"backends,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Backends") 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. "Backends") 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 *ConfigManagementPolicyControllerMonitoring) MarshalJSON() ([]byte, error) { + type NoMethod ConfigManagementPolicyControllerMonitoring + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ConfigManagementPolicyControllerState: State for // PolicyControllerState. type ConfigManagementPolicyControllerState struct { @@ -2679,6 +2804,10 @@ func (s *Membership) MarshalJSON() ([]byte, error) { // contact a Kubernetes API, endpoint and any additional Kubernetes // metadata. type MembershipEndpoint struct { + // ApplianceCluster: Optional. Specific information for a GDC Edge + // Appliance cluster. + ApplianceCluster *ApplianceCluster `json:"applianceCluster,omitempty"` + // EdgeCluster: Optional. Specific information for a Google Edge // cluster. EdgeCluster *EdgeCluster `json:"edgeCluster,omitempty"` @@ -2707,7 +2836,7 @@ type MembershipEndpoint struct { // allowed to use this field, it should have a nil "type" instead. OnPremCluster *OnPremCluster `json:"onPremCluster,omitempty"` - // ForceSendFields is a list of field names (e.g. "EdgeCluster") to + // ForceSendFields is a list of field names (e.g. "ApplianceCluster") 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 @@ -2715,12 +2844,13 @@ type MembershipEndpoint struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EdgeCluster") 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. "ApplianceCluster") 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/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index f67fc6fef56..24d2571dfdc 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -1151,7 +1151,7 @@ } } }, - "revision": "20220505", + "revision": "20220530", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -1287,6 +1287,17 @@ }, "type": "object" }, + "ApplianceCluster": { + "description": "ApplianceCluster contains information specific to GDC Edge Appliance Clusters.", + "id": "ApplianceCluster", + "properties": { + "resourceLink": { + "description": "Immutable. Self-link of the GCP resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", + "type": "string" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1536,6 +1547,10 @@ "$ref": "ConfigManagementGitConfig", "description": "Git repo configuration for the cluster." }, + "oci": { + "$ref": "ConfigManagementOciConfig", + "description": "OCI repo configuration for the cluster" + }, "preventDrift": { "description": "Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", "type": "boolean" @@ -2018,6 +2033,34 @@ }, "type": "object" }, + "ConfigManagementOciConfig": { + "description": "OCI repo configuration for a single cluster", + "id": "ConfigManagementOciConfig", + "properties": { + "gcpServiceAccountEmail": { + "description": "The GCP Service Account Email used for auth when secret_type is gcpServiceAccount.", + "type": "string" + }, + "policyDir": { + "description": "The absolute path of the directory that contains the local resources. Default: the root directory of the image.", + "type": "string" + }, + "secretType": { + "description": "Type of secret configured for access to the Git repo.", + "type": "string" + }, + "syncRepo": { + "description": "The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", + "type": "string" + }, + "syncWaitSecs": { + "description": "Period in seconds between consecutive syncs. Default: 15.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "ConfigManagementOperatorState": { "description": "State information for an ACM's Operator", "id": "ConfigManagementOperatorState", @@ -2076,6 +2119,10 @@ "description": "Logs all denies and dry run failures.", "type": "boolean" }, + "monitoring": { + "$ref": "ConfigManagementPolicyControllerMonitoring", + "description": "Monitoring specifies the configuration of monitoring." + }, "mutationEnabled": { "description": "Enable users to try out mutation for PolicyController.", "type": "boolean" @@ -2091,6 +2138,30 @@ }, "type": "object" }, + "ConfigManagementPolicyControllerMonitoring": { + "description": "PolicyControllerMonitoring specifies the backends Policy Controller should export metrics to. For example, to specify metrics should be exported to Cloud Monitoring and Prometheus, specify backends: [\"cloudmonitoring\", \"prometheus\"]", + "id": "ConfigManagementPolicyControllerMonitoring", + "properties": { + "backends": { + "description": "Specifies the list of backends Policy Controller will export to. An empty list would effectively disable metrics export.", + "items": { + "enum": [ + "MONITORING_BACKEND_UNSPECIFIED", + "PROMETHEUS", + "CLOUD_MONITORING" + ], + "enumDescriptions": [ + "Backend cannot be determined", + "Prometheus backend for monitoring", + "Stackdriver/Cloud Monitoring backend for monitoring" + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ConfigManagementPolicyControllerState": { "description": "State for PolicyControllerState.", "id": "ConfigManagementPolicyControllerState", @@ -2963,6 +3034,10 @@ "description": "MembershipEndpoint contains information needed to contact a Kubernetes API, endpoint and any additional Kubernetes metadata.", "id": "MembershipEndpoint", "properties": { + "applianceCluster": { + "$ref": "ApplianceCluster", + "description": "Optional. Specific information for a GDC Edge Appliance cluster." + }, "edgeCluster": { "$ref": "EdgeCluster", "description": "Optional. Specific information for a Google Edge cluster." diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 89a99fd8520..0db14497285 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -507,6 +507,38 @@ func (s *AppDevExperienceFeatureState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ApplianceCluster: ApplianceCluster contains information specific to +// GDC Edge Appliance Clusters. +type ApplianceCluster struct { + // ResourceLink: Immutable. Self-link of the GCP resource for the + // Appliance Cluster. For example: + // //transferappliance.googleapis.com/projects/my-project/locations/us-we + // st1-a/appliances/my-appliance + ResourceLink string `json:"resourceLink,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourceLink") 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. "ResourceLink") 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 *ApplianceCluster) MarshalJSON() ([]byte, error) { + type NoMethod ApplianceCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must @@ -1001,6 +1033,9 @@ type ConfigManagementConfigSync struct { // Git: Git repo configuration for the cluster. Git *ConfigManagementGitConfig `json:"git,omitempty"` + // Oci: OCI repo configuration for the cluster + Oci *ConfigManagementOciConfig `json:"oci,omitempty"` + // PreventDrift: Set to true to enable the Config Sync admission webhook // to prevent drifts. If set to `false`, disables the Config Sync // admission webhook and does not prevent drifts. @@ -1683,6 +1718,54 @@ func (s *ConfigManagementMembershipState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ConfigManagementOciConfig: OCI repo configuration for a single +// cluster +type ConfigManagementOciConfig struct { + // GcpServiceAccountEmail: The GCP Service Account Email used for auth + // when secret_type is gcpServiceAccount. + GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` + + // PolicyDir: The absolute path of the directory that contains the local + // resources. Default: the root directory of the image. + PolicyDir string `json:"policyDir,omitempty"` + + // SecretType: Type of secret configured for access to the Git repo. + SecretType string `json:"secretType,omitempty"` + + // SyncRepo: The OCI image repository URL for the package to sync from. + // e.g. + // `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`. + SyncRepo string `json:"syncRepo,omitempty"` + + // SyncWaitSecs: Period in seconds between consecutive syncs. Default: + // 15. + SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. + // "GcpServiceAccountEmail") 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. "GcpServiceAccountEmail") + // 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 *ConfigManagementOciConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConfigManagementOciConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ConfigManagementOperatorState: State information for an ACM's // Operator type ConfigManagementOperatorState struct { @@ -1745,6 +1828,9 @@ type ConfigManagementPolicyController struct { // LogDeniesEnabled: Logs all denies and dry run failures. LogDeniesEnabled bool `json:"logDeniesEnabled,omitempty"` + // Monitoring: Monitoring specifies the configuration of monitoring. + Monitoring *ConfigManagementPolicyControllerMonitoring `json:"monitoring,omitempty"` + // MutationEnabled: Enable users to try out mutation for // PolicyController. MutationEnabled bool `json:"mutationEnabled,omitempty"` @@ -1783,6 +1869,45 @@ func (s *ConfigManagementPolicyController) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ConfigManagementPolicyControllerMonitoring: +// PolicyControllerMonitoring specifies the backends Policy Controller +// should export metrics to. For example, to specify metrics should be +// exported to Cloud Monitoring and Prometheus, specify backends: +// ["cloudmonitoring", "prometheus"] +type ConfigManagementPolicyControllerMonitoring struct { + // Backends: Specifies the list of backends Policy Controller will + // export to. An empty list would effectively disable metrics export. + // + // Possible values: + // "MONITORING_BACKEND_UNSPECIFIED" - Backend cannot be determined + // "PROMETHEUS" - Prometheus backend for monitoring + // "CLOUD_MONITORING" - Stackdriver/Cloud Monitoring backend for + // monitoring + Backends []string `json:"backends,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Backends") 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. "Backends") 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 *ConfigManagementPolicyControllerMonitoring) MarshalJSON() ([]byte, error) { + type NoMethod ConfigManagementPolicyControllerMonitoring + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ConfigManagementPolicyControllerState: State for // PolicyControllerState. type ConfigManagementPolicyControllerState struct { @@ -3192,6 +3317,10 @@ func (s *Membership) MarshalJSON() ([]byte, error) { // contact a Kubernetes API, endpoint and any additional Kubernetes // metadata. type MembershipEndpoint struct { + // ApplianceCluster: Optional. Specific information for a GDC Edge + // Appliance cluster. + ApplianceCluster *ApplianceCluster `json:"applianceCluster,omitempty"` + // EdgeCluster: Optional. Specific information for a Google Edge // cluster. EdgeCluster *EdgeCluster `json:"edgeCluster,omitempty"` @@ -3220,7 +3349,7 @@ type MembershipEndpoint struct { // allowed to use this field, it should have a nil "type" instead. OnPremCluster *OnPremCluster `json:"onPremCluster,omitempty"` - // ForceSendFields is a list of field names (e.g. "EdgeCluster") to + // ForceSendFields is a list of field names (e.g. "ApplianceCluster") 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 @@ -3228,12 +3357,13 @@ type MembershipEndpoint struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EdgeCluster") 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. "ApplianceCluster") 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/gkehub/v1beta1/gkehub-api.json b/gkehub/v1beta1/gkehub-api.json index 1a864bde7b1..bf790618685 100644 --- a/gkehub/v1beta1/gkehub-api.json +++ b/gkehub/v1beta1/gkehub-api.json @@ -706,9 +706,20 @@ } } }, - "revision": "20220505", + "revision": "20220530", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { + "ApplianceCluster": { + "description": "ApplianceCluster contains information specific to GDC Edge Appliance Clusters.", + "id": "ApplianceCluster", + "properties": { + "resourceLink": { + "description": "Immutable. Self-link of the GCP resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", + "type": "string" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1192,6 +1203,10 @@ "description": "MembershipEndpoint contains information needed to contact a Kubernetes API, endpoint and any additional Kubernetes metadata.", "id": "MembershipEndpoint", "properties": { + "applianceCluster": { + "$ref": "ApplianceCluster", + "description": "Optional. Specific information for a GDC Edge Appliance cluster." + }, "edgeCluster": { "$ref": "EdgeCluster", "description": "Optional. Specific information for a Google Edge cluster." diff --git a/gkehub/v1beta1/gkehub-gen.go b/gkehub/v1beta1/gkehub-gen.go index a659822e0cc..5cb6837abe4 100644 --- a/gkehub/v1beta1/gkehub-gen.go +++ b/gkehub/v1beta1/gkehub-gen.go @@ -182,6 +182,38 @@ type ProjectsLocationsOperationsService struct { s *Service } +// ApplianceCluster: ApplianceCluster contains information specific to +// GDC Edge Appliance Clusters. +type ApplianceCluster struct { + // ResourceLink: Immutable. Self-link of the GCP resource for the + // Appliance Cluster. For example: + // //transferappliance.googleapis.com/projects/my-project/locations/us-we + // st1-a/appliances/my-appliance + ResourceLink string `json:"resourceLink,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourceLink") 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. "ResourceLink") 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 *ApplianceCluster) MarshalJSON() ([]byte, error) { + type NoMethod ApplianceCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must @@ -1092,6 +1124,10 @@ func (s *Membership) MarshalJSON() ([]byte, error) { // contact a Kubernetes API, endpoint and any additional Kubernetes // metadata. type MembershipEndpoint struct { + // ApplianceCluster: Optional. Specific information for a GDC Edge + // Appliance cluster. + ApplianceCluster *ApplianceCluster `json:"applianceCluster,omitempty"` + // EdgeCluster: Optional. Specific information for a Google Edge // cluster. EdgeCluster *EdgeCluster `json:"edgeCluster,omitempty"` @@ -1120,7 +1156,7 @@ type MembershipEndpoint struct { // allowed to use this field, it should have a nil "type" instead. OnPremCluster *OnPremCluster `json:"onPremCluster,omitempty"` - // ForceSendFields is a list of field names (e.g. "EdgeCluster") to + // ForceSendFields is a list of field names (e.g. "ApplianceCluster") 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 @@ -1128,12 +1164,13 @@ type MembershipEndpoint struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EdgeCluster") 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. "ApplianceCluster") 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/jobs/v3/jobs-api.json b/jobs/v3/jobs-api.json index 97232b765fd..12b971828f5 100644 --- a/jobs/v3/jobs-api.json +++ b/jobs/v3/jobs-api.json @@ -651,7 +651,7 @@ } } }, - "revision": "20220513", + "revision": "20220606", "rootUrl": "https://jobs.googleapis.com/", "schemas": { "ApplicationInfo": { @@ -2203,7 +2203,7 @@ ], "enumDescriptions": [ "Default value if the telecommute preference is not specified.", - "DEPRECATED. Ignore telecommute status of jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.", + "Deprecated: Ignore telecommute status of jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.", "Allow telecommute jobs.", "Exclude telecommute jobs." ], @@ -2275,7 +2275,7 @@ "type": "object" }, "NamespacedDebugInput": { - "description": "Next ID: 15", + "description": "Next ID: 16", "id": "NamespacedDebugInput", "properties": { "absolutelyForcedExpNames": { @@ -2369,6 +2369,20 @@ }, "description": "Rollouts to force in a particular experiment state. Map from rollout name to rollout value.", "type": "object" + }, + "testingMode": { + "description": "If set to ALL_OFF, organic selection will be disabled; if set to ALL_ON, organic selection will be disabled, and only select launch experiments will receive traffic. See go/mendel-aoao-runtime-design.", + "enum": [ + "TESTING_MODE_UNSPECIFIED", + "TESTING_MODE_ALL_OFF", + "TESTING_MODE_ALL_ON" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" } }, "type": "object" diff --git a/jobs/v3/jobs-gen.go b/jobs/v3/jobs-gen.go index 1c2592d631b..9cd586473e1 100644 --- a/jobs/v3/jobs-gen.go +++ b/jobs/v3/jobs-gen.go @@ -2612,7 +2612,7 @@ type LocationFilter struct { // Possible values: // "TELECOMMUTE_PREFERENCE_UNSPECIFIED" - Default value if the // telecommute preference is not specified. - // "TELECOMMUTE_EXCLUDED" - DEPRECATED. Ignore telecommute status of + // "TELECOMMUTE_EXCLUDED" - Deprecated: Ignore telecommute status of // jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute // jobs. // "TELECOMMUTE_ALLOWED" - Allow telecommute jobs. @@ -2785,7 +2785,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NamespacedDebugInput: Next ID: 15 +// NamespacedDebugInput: Next ID: 16 type NamespacedDebugInput struct { // AbsolutelyForcedExpNames: Set of experiment names to be absolutely // forced. These experiments will be forced without evaluating the @@ -2874,6 +2874,17 @@ type NamespacedDebugInput struct { // Map from rollout name to rollout value. ForcedRollouts map[string]bool `json:"forcedRollouts,omitempty"` + // TestingMode: If set to ALL_OFF, organic selection will be disabled; + // if set to ALL_ON, organic selection will be disabled, and only select + // launch experiments will receive traffic. See + // go/mendel-aoao-runtime-design. + // + // Possible values: + // "TESTING_MODE_UNSPECIFIED" + // "TESTING_MODE_ALL_OFF" + // "TESTING_MODE_ALL_ON" + TestingMode string `json:"testingMode,omitempty"` + // ForceSendFields is a list of field names (e.g. // "AbsolutelyForcedExpNames") to unconditionally include in API // requests. By default, fields with empty or default values are omitted diff --git a/jobs/v3p1beta1/jobs-api.json b/jobs/v3p1beta1/jobs-api.json index 7980ae93d55..62c26dbbc05 100644 --- a/jobs/v3p1beta1/jobs-api.json +++ b/jobs/v3p1beta1/jobs-api.json @@ -681,7 +681,7 @@ } } }, - "revision": "20220513", + "revision": "20220606", "rootUrl": "https://jobs.googleapis.com/", "schemas": { "ApplicationInfo": { @@ -2307,7 +2307,7 @@ ], "enumDescriptions": [ "Default value if the telecommute preference is not specified.", - "DEPRECATED. Ignore telecommute status of jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.", + "Deprecated: Ignore telecommute status of jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.", "Allow telecommute jobs.", "Exclude telecommute jobs." ], @@ -2379,7 +2379,7 @@ "type": "object" }, "NamespacedDebugInput": { - "description": "Next ID: 15", + "description": "Next ID: 16", "id": "NamespacedDebugInput", "properties": { "absolutelyForcedExpNames": { @@ -2473,6 +2473,20 @@ }, "description": "Rollouts to force in a particular experiment state. Map from rollout name to rollout value.", "type": "object" + }, + "testingMode": { + "description": "If set to ALL_OFF, organic selection will be disabled; if set to ALL_ON, organic selection will be disabled, and only select launch experiments will receive traffic. See go/mendel-aoao-runtime-design.", + "enum": [ + "TESTING_MODE_UNSPECIFIED", + "TESTING_MODE_ALL_OFF", + "TESTING_MODE_ALL_ON" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" } }, "type": "object" diff --git a/jobs/v3p1beta1/jobs-gen.go b/jobs/v3p1beta1/jobs-gen.go index 977657f702f..7599ed56006 100644 --- a/jobs/v3p1beta1/jobs-gen.go +++ b/jobs/v3p1beta1/jobs-gen.go @@ -2834,7 +2834,7 @@ type LocationFilter struct { // Possible values: // "TELECOMMUTE_PREFERENCE_UNSPECIFIED" - Default value if the // telecommute preference is not specified. - // "TELECOMMUTE_EXCLUDED" - DEPRECATED. Ignore telecommute status of + // "TELECOMMUTE_EXCLUDED" - Deprecated: Ignore telecommute status of // jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute // jobs. // "TELECOMMUTE_ALLOWED" - Allow telecommute jobs. @@ -3007,7 +3007,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NamespacedDebugInput: Next ID: 15 +// NamespacedDebugInput: Next ID: 16 type NamespacedDebugInput struct { // AbsolutelyForcedExpNames: Set of experiment names to be absolutely // forced. These experiments will be forced without evaluating the @@ -3096,6 +3096,17 @@ type NamespacedDebugInput struct { // Map from rollout name to rollout value. ForcedRollouts map[string]bool `json:"forcedRollouts,omitempty"` + // TestingMode: If set to ALL_OFF, organic selection will be disabled; + // if set to ALL_ON, organic selection will be disabled, and only select + // launch experiments will receive traffic. See + // go/mendel-aoao-runtime-design. + // + // Possible values: + // "TESTING_MODE_UNSPECIFIED" + // "TESTING_MODE_ALL_OFF" + // "TESTING_MODE_ALL_ON" + TestingMode string `json:"testingMode,omitempty"` + // ForceSendFields is a list of field names (e.g. // "AbsolutelyForcedExpNames") to unconditionally include in API // requests. By default, fields with empty or default values are omitted diff --git a/jobs/v4/jobs-api.json b/jobs/v4/jobs-api.json index 8fed443017f..697c70e9174 100644 --- a/jobs/v4/jobs-api.json +++ b/jobs/v4/jobs-api.json @@ -903,7 +903,7 @@ } } }, - "revision": "20220513", + "revision": "20220606", "rootUrl": "https://jobs.googleapis.com/", "schemas": { "ApplicationInfo": { @@ -2399,7 +2399,7 @@ ], "enumDescriptions": [ "Default value if the telecommute preference isn't specified.", - "DEPRECATED. Ignore telecommute status of jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.", + "Deprecated: Ignore telecommute status of jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute jobs.", "Allow telecommute jobs.", "Exclude telecommute jobs." ], @@ -2471,7 +2471,7 @@ "type": "object" }, "NamespacedDebugInput": { - "description": "Next ID: 15", + "description": "Next ID: 16", "id": "NamespacedDebugInput", "properties": { "absolutelyForcedExpNames": { @@ -2565,6 +2565,20 @@ }, "description": "Rollouts to force in a particular experiment state. Map from rollout name to rollout value.", "type": "object" + }, + "testingMode": { + "description": "If set to ALL_OFF, organic selection will be disabled; if set to ALL_ON, organic selection will be disabled, and only select launch experiments will receive traffic. See go/mendel-aoao-runtime-design.", + "enum": [ + "TESTING_MODE_UNSPECIFIED", + "TESTING_MODE_ALL_OFF", + "TESTING_MODE_ALL_ON" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" } }, "type": "object" diff --git a/jobs/v4/jobs-gen.go b/jobs/v4/jobs-gen.go index dc3c1bd8a70..7964997ac0a 100644 --- a/jobs/v4/jobs-gen.go +++ b/jobs/v4/jobs-gen.go @@ -2537,7 +2537,7 @@ type LocationFilter struct { // Possible values: // "TELECOMMUTE_PREFERENCE_UNSPECIFIED" - Default value if the // telecommute preference isn't specified. - // "TELECOMMUTE_EXCLUDED" - DEPRECATED. Ignore telecommute status of + // "TELECOMMUTE_EXCLUDED" - Deprecated: Ignore telecommute status of // jobs. Use TELECOMMUTE_JOBS_EXCLUDED if want to exclude telecommute // jobs. // "TELECOMMUTE_ALLOWED" - Allow telecommute jobs. @@ -2709,7 +2709,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NamespacedDebugInput: Next ID: 15 +// NamespacedDebugInput: Next ID: 16 type NamespacedDebugInput struct { // AbsolutelyForcedExpNames: Set of experiment names to be absolutely // forced. These experiments will be forced without evaluating the @@ -2798,6 +2798,17 @@ type NamespacedDebugInput struct { // Map from rollout name to rollout value. ForcedRollouts map[string]bool `json:"forcedRollouts,omitempty"` + // TestingMode: If set to ALL_OFF, organic selection will be disabled; + // if set to ALL_ON, organic selection will be disabled, and only select + // launch experiments will receive traffic. See + // go/mendel-aoao-runtime-design. + // + // Possible values: + // "TESTING_MODE_UNSPECIFIED" + // "TESTING_MODE_ALL_OFF" + // "TESTING_MODE_ALL_ON" + TestingMode string `json:"testingMode,omitempty"` + // ForceSendFields is a list of field names (e.g. // "AbsolutelyForcedExpNames") to unconditionally include in API // requests. By default, fields with empty or default values are omitted diff --git a/managedidentities/v1/managedidentities-api.json b/managedidentities/v1/managedidentities-api.json index 085dd358430..4ff9d221e65 100644 --- a/managedidentities/v1/managedidentities-api.json +++ b/managedidentities/v1/managedidentities-api.json @@ -336,7 +336,7 @@ "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -550,7 +550,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -578,7 +578,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -761,7 +761,7 @@ "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "required": true, @@ -866,7 +866,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "required": true, @@ -894,7 +894,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "required": true, @@ -1215,7 +1215,7 @@ "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "required": true, @@ -1320,7 +1320,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "required": true, @@ -1348,7 +1348,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "required": true, @@ -1375,7 +1375,7 @@ } } }, - "revision": "20220331", + "revision": "20220526", "rootUrl": "https://managedidentities.googleapis.com/", "schemas": { "AttachTrustRequest": { @@ -1468,7 +1468,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, @@ -1845,7 +1845,7 @@ "type": "string" }, "instanceType": { - "description": "Optional. The instance_type of this instance of format: projects/{project_id}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", + "description": "Optional. The instance_type of this instance of format: projects/{project_number}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", "type": "string" }, "labels": { @@ -1874,7 +1874,7 @@ "description": "Optional. The MaintenanceSettings associated with instance." }, "name": { - "description": "Unique name of the resource. It uses the form: `projects/{project_id|project_number}/locations/{location_id}/instances/{instance_id}` Note: Either project_id or project_number can be used, but keep it consistent with other APIs (e.g. RescheduleUpdate)", + "description": "Unique name of the resource. It uses the form: `projects/{project_number}/locations/{location_id}/instances/{instance_id}` Note: This name is passed, stored and logged across the rollout system. So use of consumer project_id or any other consumer PII in the name is strongly discouraged for wipeout (go/wipeout) compliance. See go/elysium/project_ids#storage-guidance for more details.", "type": "string" }, "notificationParameters": { @@ -2645,7 +2645,7 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them." + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." } }, "type": "object" @@ -2726,7 +2726,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, diff --git a/managedidentities/v1/managedidentities-gen.go b/managedidentities/v1/managedidentities-gen.go index 4e7f562aa28..d6d51d8f7df 100644 --- a/managedidentities/v1/managedidentities-gen.go +++ b/managedidentities/v1/managedidentities-gen.go @@ -337,8 +337,8 @@ type Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Cloud - // Platform resource. `members` can have the following values: * + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * // `allUsers`: A special identifier that represents anyone who is on the // internet; with or without a Google account. * // `allAuthenticatedUsers`: A special identifier that represents anyone @@ -923,11 +923,12 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { CreateTime string `json:"createTime,omitempty"` // InstanceType: Optional. The instance_type of this instance of format: - // projects/{project_id}/locations/{location_id}/instanceTypes/{instance_ - // type_id}. Instance Type represents a high-level tier or SKU of the - // service that this instance belong to. When enabled(eg: Maintenance - // Rollout), Rollout uses 'instance_type' along with 'software_versions' - // to determine whether instance needs an update or not. + // projects/{project_number}/locations/{location_id}/instanceTypes/{insta + // nce_type_id}. Instance Type represents a high-level tier or SKU of + // the service that this instance belong to. When enabled(eg: + // Maintenance Rollout), Rollout uses 'instance_type' along with + // 'software_versions' to determine whether instance needs an update or + // not. InstanceType string `json:"instanceType,omitempty"` // Labels: Optional. Resource labels to represent user provided @@ -952,9 +953,11 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { MaintenanceSettings *GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings `json:"maintenanceSettings,omitempty"` // Name: Unique name of the resource. It uses the form: - // `projects/{project_id|project_number}/locations/{location_id}/instance - // s/{instance_id}` Note: Either project_id or project_number can be - // used, but keep it consistent with other APIs (e.g. RescheduleUpdate) + // `projects/{project_number}/locations/{location_id}/instances/{instance + // _id}` Note: This name is passed, stored and logged across the rollout + // system. So use of consumer project_id or any other consumer PII in + // the name is strongly discouraged for wipeout (go/wipeout) compliance. + // See go/elysium/project_ids#storage-guidance for more details. Name string `json:"name,omitempty"` // NotificationParameters: Optional. notification_parameter are @@ -2263,7 +2266,7 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Cloud Platform services + // empty policy is a valid policy but certain Google Cloud services // (such as Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2391,7 +2394,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { // method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as '*' or 'storage.*') are not + // Permissions with wildcards (such as `*` or `storage.*`) are not // allowed. For more information see IAM Overview // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` @@ -3789,8 +3792,9 @@ type ProjectsLocationsGlobalDomainsGetIamPolicyCall struct { // set. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See the operation documentation for the appropriate -// value for this field. +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -3929,7 +3933,7 @@ func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) Do(opts ...googleapi.Ca // "type": "integer" // }, // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", // "required": true, @@ -4923,8 +4927,9 @@ type ProjectsLocationsGlobalDomainsSetIamPolicyCall struct { // `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See the operation documentation for the appropriate -// value for this field. +// specified. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGlobalDomainsSetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -5032,7 +5037,7 @@ func (c *ProjectsLocationsGlobalDomainsSetIamPolicyCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", // "required": true, @@ -5072,7 +5077,8 @@ type ProjectsLocationsGlobalDomainsTestIamPermissionsCall struct { // operation may "fail open" without warning. // // - resource: REQUIRED: The resource for which the policy detail is -// being requested. See the operation documentation for the +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGlobalDomainsTestIamPermissionsCall { c := &ProjectsLocationsGlobalDomainsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5181,7 +5187,7 @@ func (c *ProjectsLocationsGlobalDomainsTestIamPermissionsCall) Do(opts ...google // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", // "required": true, @@ -5962,8 +5968,9 @@ type ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall struct { // set. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See the operation documentation for the appropriate -// value for this field. +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsBackupsService) GetIamPolicy(resource string) *ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6102,7 +6109,7 @@ func (c *ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall) Do(opts ...googl // "type": "integer" // }, // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", // "required": true, @@ -6518,8 +6525,9 @@ type ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall struct { // `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See the operation documentation for the appropriate -// value for this field. +// specified. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsBackupsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6627,7 +6635,7 @@ func (c *ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall) Do(opts ...googl // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", // "required": true, @@ -6667,7 +6675,8 @@ type ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall struct { // operation may "fail open" without warning. // // - resource: REQUIRED: The resource for which the policy detail is -// being requested. See the operation documentation for the +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsBackupsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall { c := &ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -6776,7 +6785,7 @@ func (c *ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall) Do(opts .. // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", // "required": true, @@ -8267,8 +8276,9 @@ type ProjectsLocationsGlobalPeeringsGetIamPolicyCall struct { // set. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See the operation documentation for the appropriate -// value for this field. +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalPeeringsService) GetIamPolicy(resource string) *ProjectsLocationsGlobalPeeringsGetIamPolicyCall { c := &ProjectsLocationsGlobalPeeringsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -8407,7 +8417,7 @@ func (c *ProjectsLocationsGlobalPeeringsGetIamPolicyCall) Do(opts ...googleapi.C // "type": "integer" // }, // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", // "required": true, @@ -8824,8 +8834,9 @@ type ProjectsLocationsGlobalPeeringsSetIamPolicyCall struct { // `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See the operation documentation for the appropriate -// value for this field. +// specified. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalPeeringsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGlobalPeeringsSetIamPolicyCall { c := &ProjectsLocationsGlobalPeeringsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -8933,7 +8944,7 @@ func (c *ProjectsLocationsGlobalPeeringsSetIamPolicyCall) Do(opts ...googleapi.C // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", // "required": true, @@ -8973,7 +8984,8 @@ type ProjectsLocationsGlobalPeeringsTestIamPermissionsCall struct { // operation may "fail open" without warning. // // - resource: REQUIRED: The resource for which the policy detail is -// being requested. See the operation documentation for the +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. func (r *ProjectsLocationsGlobalPeeringsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGlobalPeeringsTestIamPermissionsCall { c := &ProjectsLocationsGlobalPeeringsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9082,7 +9094,7 @@ func (c *ProjectsLocationsGlobalPeeringsTestIamPermissionsCall) Do(opts ...googl // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", // "required": true, diff --git a/managedidentities/v1alpha1/managedidentities-api.json b/managedidentities/v1alpha1/managedidentities-api.json index ab9976e4e2f..c0c72093810 100644 --- a/managedidentities/v1alpha1/managedidentities-api.json +++ b/managedidentities/v1alpha1/managedidentities-api.json @@ -295,6 +295,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "extendSchema": { + "description": "Extend Schema for Domain", + "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:extendSchema", + "httpMethod": "POST", + "id": "managedidentities.projects.locations.global.domains.extendSchema", + "parameterOrder": [ + "domain" + ], + "parameters": { + "domain": { + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+domain}:extendSchema", + "request": { + "$ref": "ExtendSchemaRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets details of a single Domain.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}", @@ -336,7 +364,7 @@ "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -550,7 +578,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -578,7 +606,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -761,7 +789,7 @@ "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "required": true, @@ -866,7 +894,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "required": true, @@ -894,7 +922,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "required": true, @@ -1215,7 +1243,7 @@ "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "required": true, @@ -1320,7 +1348,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "required": true, @@ -1348,7 +1376,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "required": true, @@ -1375,7 +1403,7 @@ } } }, - "revision": "20220331", + "revision": "20220526", "rootUrl": "https://managedidentities.googleapis.com/", "schemas": { "AttachTrustRequest": { @@ -1398,6 +1426,10 @@ "readOnly": true, "type": "string" }, + "description": { + "description": "Optional. A short description of the backup.", + "type": "string" + }, "labels": { "additionalProperties": { "type": "string" @@ -1439,12 +1471,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ON_DEMAND", - "SCHEDULED" + "SCHEDULED", + "SCHEMA_EXTENSION" ], "enumDescriptions": [ + "Backup type not specified.", "Backup was manually created.", - "Backup was manually created.", - "Backup was automatically created." + "Backup was automatically created.", + "Backup was taken as part of Schema Extension request." ], "readOnly": true, "type": "string" @@ -1467,7 +1501,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, @@ -1706,6 +1740,26 @@ }, "type": "object" }, + "ExtendSchemaRequest": { + "description": "ExtendSchemaRequest is the request message for ExtendSchema method.", + "id": "ExtendSchemaRequest", + "properties": { + "description": { + "description": "Required. Description for Schema Change.", + "type": "string" + }, + "fileContents": { + "description": "File uploaded as a byte stream input.", + "format": "byte", + "type": "string" + }, + "gcsPath": { + "description": "File stored in Cloud Storage bucket and represented in the form projects/{project_id}/buckets/{bucket_name}/objects/{object_name} File should be in the same project as the domain.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudManagedidentitiesV1OpMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudManagedidentitiesV1OpMetadata", @@ -1837,7 +1891,7 @@ "type": "string" }, "instanceType": { - "description": "Optional. The instance_type of this instance of format: projects/{project_id}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", + "description": "Optional. The instance_type of this instance of format: projects/{project_number}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", "type": "string" }, "labels": { @@ -1866,7 +1920,7 @@ "description": "Optional. The MaintenanceSettings associated with instance." }, "name": { - "description": "Unique name of the resource. It uses the form: `projects/{project_id|project_number}/locations/{location_id}/instances/{instance_id}` Note: Either project_id or project_number can be used, but keep it consistent with other APIs (e.g. RescheduleUpdate)", + "description": "Unique name of the resource. It uses the form: `projects/{project_number}/locations/{location_id}/instances/{instance_id}` Note: This name is passed, stored and logged across the rollout system. So use of consumer project_id or any other consumer PII in the name is strongly discouraged for wipeout (go/wipeout) compliance. See go/elysium/project_ids#storage-guidance for more details.", "type": "string" }, "notificationParameters": { @@ -2670,7 +2724,7 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them." + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." } }, "type": "object" @@ -2707,7 +2761,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, diff --git a/managedidentities/v1alpha1/managedidentities-gen.go b/managedidentities/v1alpha1/managedidentities-gen.go index 8908c622ba9..3091d861a15 100644 --- a/managedidentities/v1alpha1/managedidentities-gen.go +++ b/managedidentities/v1alpha1/managedidentities-gen.go @@ -262,6 +262,9 @@ type Backup struct { // CreateTime: Output only. The time the backups was created. CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A short description of the backup. + Description string `json:"description,omitempty"` + // Labels: Optional. Resource labels to represent user provided // metadata. Labels map[string]string `json:"labels,omitempty"` @@ -289,9 +292,11 @@ type Backup struct { // scheduled. // // Possible values: - // "TYPE_UNSPECIFIED" - Backup was manually created. + // "TYPE_UNSPECIFIED" - Backup type not specified. // "ON_DEMAND" - Backup was manually created. // "SCHEDULED" - Backup was automatically created. + // "SCHEMA_EXTENSION" - Backup was taken as part of Schema Extension + // request. Type string `json:"type,omitempty"` // UpdateTime: Output only. Last update time. @@ -336,8 +341,8 @@ type Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Cloud - // Platform resource. `members` can have the following values: * + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * // `allUsers`: A special identifier that represents anyone who is on the // internet; with or without a Google account. * // `allAuthenticatedUsers`: A special identifier that represents anyone @@ -770,6 +775,44 @@ func (s *Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ExtendSchemaRequest: ExtendSchemaRequest is the request message for +// ExtendSchema method. +type ExtendSchemaRequest struct { + // Description: Required. Description for Schema Change. + Description string `json:"description,omitempty"` + + // FileContents: File uploaded as a byte stream input. + FileContents string `json:"fileContents,omitempty"` + + // GcsPath: File stored in Cloud Storage bucket and represented in the + // form + // projects/{project_id}/buckets/{bucket_name}/objects/{object_name} + // File should be in the same project as the domain. + GcsPath string `json:"gcsPath,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Description") 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. "Description") 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 *ExtendSchemaRequest) MarshalJSON() ([]byte, error) { + type NoMethod ExtendSchemaRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudManagedidentitiesV1OpMetadata: Represents the metadata of // the long-running operation. type GoogleCloudManagedidentitiesV1OpMetadata struct { @@ -926,11 +969,12 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { CreateTime string `json:"createTime,omitempty"` // InstanceType: Optional. The instance_type of this instance of format: - // projects/{project_id}/locations/{location_id}/instanceTypes/{instance_ - // type_id}. Instance Type represents a high-level tier or SKU of the - // service that this instance belong to. When enabled(eg: Maintenance - // Rollout), Rollout uses 'instance_type' along with 'software_versions' - // to determine whether instance needs an update or not. + // projects/{project_number}/locations/{location_id}/instanceTypes/{insta + // nce_type_id}. Instance Type represents a high-level tier or SKU of + // the service that this instance belong to. When enabled(eg: + // Maintenance Rollout), Rollout uses 'instance_type' along with + // 'software_versions' to determine whether instance needs an update or + // not. InstanceType string `json:"instanceType,omitempty"` // Labels: Optional. Resource labels to represent user provided @@ -955,9 +999,11 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { MaintenanceSettings *GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings `json:"maintenanceSettings,omitempty"` // Name: Unique name of the resource. It uses the form: - // `projects/{project_id|project_number}/locations/{location_id}/instance - // s/{instance_id}` Note: Either project_id or project_number can be - // used, but keep it consistent with other APIs (e.g. RescheduleUpdate) + // `projects/{project_number}/locations/{location_id}/instances/{instance + // _id}` Note: This name is passed, stored and logged across the rollout + // system. So use of consumer project_id or any other consumer PII in + // the name is strongly discouraged for wipeout (go/wipeout) compliance. + // See go/elysium/project_ids#storage-guidance for more details. Name string `json:"name,omitempty"` // NotificationParameters: Optional. notification_parameter are @@ -2307,7 +2353,7 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Cloud Platform services + // empty policy is a valid policy but certain Google Cloud services // (such as Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2382,7 +2428,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { // method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as '*' or 'storage.*') are not + // Permissions with wildcards (such as `*` or `storage.*`) are not // allowed. For more information see IAM Overview // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` @@ -3617,6 +3663,149 @@ func (c *ProjectsLocationsGlobalDomainsDetachTrustCall) Do(opts ...googleapi.Cal } +// method id "managedidentities.projects.locations.global.domains.extendSchema": + +type ProjectsLocationsGlobalDomainsExtendSchemaCall struct { + s *Service + domain string + extendschemarequest *ExtendSchemaRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ExtendSchema: Extend Schema for Domain +// +// - domain: The domain resource name using the form: +// `projects/{project_id}/locations/global/domains/{domain_name}`. +func (r *ProjectsLocationsGlobalDomainsService) ExtendSchema(domain string, extendschemarequest *ExtendSchemaRequest) *ProjectsLocationsGlobalDomainsExtendSchemaCall { + c := &ProjectsLocationsGlobalDomainsExtendSchemaCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.domain = domain + c.extendschemarequest = extendschemarequest + 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 *ProjectsLocationsGlobalDomainsExtendSchemaCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalDomainsExtendSchemaCall { + 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 *ProjectsLocationsGlobalDomainsExtendSchemaCall) Context(ctx context.Context) *ProjectsLocationsGlobalDomainsExtendSchemaCall { + 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 *ProjectsLocationsGlobalDomainsExtendSchemaCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalDomainsExtendSchemaCall) 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.extendschemarequest) + 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, "v1alpha1/{+domain}:extendSchema") + 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{ + "domain": c.domain, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedidentities.projects.locations.global.domains.extendSchema" 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 *ProjectsLocationsGlobalDomainsExtendSchemaCall) 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, &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, 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": "Extend Schema for Domain", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:extendSchema", + // "httpMethod": "POST", + // "id": "managedidentities.projects.locations.global.domains.extendSchema", + // "parameterOrder": [ + // "domain" + // ], + // "parameters": { + // "domain": { + // "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+domain}:extendSchema", + // "request": { + // "$ref": "ExtendSchemaRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "managedidentities.projects.locations.global.domains.get": type ProjectsLocationsGlobalDomainsGetCall struct { @@ -3780,8 +3969,9 @@ type ProjectsLocationsGlobalDomainsGetIamPolicyCall struct { // set. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See the operation documentation for the appropriate -// value for this field. +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsService) GetIamPolicy(resource string) *ProjectsLocationsGlobalDomainsGetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -3920,7 +4110,7 @@ func (c *ProjectsLocationsGlobalDomainsGetIamPolicyCall) Do(opts ...googleapi.Ca // "type": "integer" // }, // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", // "required": true, @@ -4915,8 +5105,9 @@ type ProjectsLocationsGlobalDomainsSetIamPolicyCall struct { // `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See the operation documentation for the appropriate -// value for this field. +// specified. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGlobalDomainsSetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -5024,7 +5215,7 @@ func (c *ProjectsLocationsGlobalDomainsSetIamPolicyCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", // "required": true, @@ -5064,7 +5255,8 @@ type ProjectsLocationsGlobalDomainsTestIamPermissionsCall struct { // operation may "fail open" without warning. // // - resource: REQUIRED: The resource for which the policy detail is -// being requested. See the operation documentation for the +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGlobalDomainsTestIamPermissionsCall { c := &ProjectsLocationsGlobalDomainsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5173,7 +5365,7 @@ func (c *ProjectsLocationsGlobalDomainsTestIamPermissionsCall) Do(opts ...google // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", // "required": true, @@ -5952,8 +6144,9 @@ type ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall struct { // set. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See the operation documentation for the appropriate -// value for this field. +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsBackupsService) GetIamPolicy(resource string) *ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6092,7 +6285,7 @@ func (c *ProjectsLocationsGlobalDomainsBackupsGetIamPolicyCall) Do(opts ...googl // "type": "integer" // }, // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", // "required": true, @@ -6507,8 +6700,9 @@ type ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall struct { // `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See the operation documentation for the appropriate -// value for this field. +// specified. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsBackupsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall { c := &ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -6616,7 +6810,7 @@ func (c *ProjectsLocationsGlobalDomainsBackupsSetIamPolicyCall) Do(opts ...googl // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", // "required": true, @@ -6656,7 +6850,8 @@ type ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall struct { // operation may "fail open" without warning. // // - resource: REQUIRED: The resource for which the policy detail is -// being requested. See the operation documentation for the +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. func (r *ProjectsLocationsGlobalDomainsBackupsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall { c := &ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -6765,7 +6960,7 @@ func (c *ProjectsLocationsGlobalDomainsBackupsTestIamPermissionsCall) Do(opts .. // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", // "required": true, @@ -8255,8 +8450,9 @@ type ProjectsLocationsGlobalPeeringsGetIamPolicyCall struct { // set. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See the operation documentation for the appropriate -// value for this field. +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalPeeringsService) GetIamPolicy(resource string) *ProjectsLocationsGlobalPeeringsGetIamPolicyCall { c := &ProjectsLocationsGlobalPeeringsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -8395,7 +8591,7 @@ func (c *ProjectsLocationsGlobalPeeringsGetIamPolicyCall) Do(opts ...googleapi.C // "type": "integer" // }, // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", // "required": true, @@ -8811,8 +9007,9 @@ type ProjectsLocationsGlobalPeeringsSetIamPolicyCall struct { // `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See the operation documentation for the appropriate -// value for this field. +// specified. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. func (r *ProjectsLocationsGlobalPeeringsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGlobalPeeringsSetIamPolicyCall { c := &ProjectsLocationsGlobalPeeringsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource @@ -8920,7 +9117,7 @@ func (c *ProjectsLocationsGlobalPeeringsSetIamPolicyCall) Do(opts ...googleapi.C // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", // "required": true, @@ -8960,7 +9157,8 @@ type ProjectsLocationsGlobalPeeringsTestIamPermissionsCall struct { // operation may "fail open" without warning. // // - resource: REQUIRED: The resource for which the policy detail is -// being requested. See the operation documentation for the +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. func (r *ProjectsLocationsGlobalPeeringsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGlobalPeeringsTestIamPermissionsCall { c := &ProjectsLocationsGlobalPeeringsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -9069,7 +9267,7 @@ func (c *ProjectsLocationsGlobalPeeringsTestIamPermissionsCall) Do(opts ...googl // ], // "parameters": { // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", // "required": true, diff --git a/paymentsresellersubscription/v1/paymentsresellersubscription-api.json b/paymentsresellersubscription/v1/paymentsresellersubscription-api.json index a715db0a25c..9078bd9b751 100644 --- a/paymentsresellersubscription/v1/paymentsresellersubscription-api.json +++ b/paymentsresellersubscription/v1/paymentsresellersubscription-api.json @@ -396,7 +396,7 @@ } } }, - "revision": "20220504", + "revision": "20220606", "rootUrl": "https://paymentsresellersubscription.googleapis.com/", "schemas": { "GoogleCloudPaymentsResellerSubscriptionV1CancelSubscriptionRequest": { @@ -755,7 +755,7 @@ "type": "object" }, "GoogleCloudPaymentsResellerSubscriptionV1Subscription": { - "description": "A Subscription resource managed by 3P Partners.", + "description": "LINT.IfChange A Subscription resource managed by 3P Partners.", "id": "GoogleCloudPaymentsResellerSubscriptionV1Subscription", "properties": { "cancellationDetails": { @@ -921,9 +921,14 @@ "type": "object" }, "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem": { - "description": "Individual line item definition of a subscription. Next id: 5", + "description": "Individual line item definition of a subscription. Next id: 6", "id": "GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem", "properties": { + "description": { + "description": "Output only. Description of this line item.", + "readOnly": true, + "type": "string" + }, "lineItemFreeTrialEndTime": { "description": "Output only. It is set only if the line item has its own free trial applied. End time of the line item free trial period, in ISO 8061 format. For example, \"2019-08-31T17:28:54.564Z\". It will be set the same as createTime if no free trial promotion is specified.", "format": "google-datetime", diff --git a/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go b/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go index d6917651ca6..7170a28de7f 100644 --- a/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go +++ b/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go @@ -812,8 +812,8 @@ func (s *GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDe return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudPaymentsResellerSubscriptionV1Subscription: A Subscription -// resource managed by 3P Partners. +// GoogleCloudPaymentsResellerSubscriptionV1Subscription: LINT.IfChange +// A Subscription resource managed by 3P Partners. type GoogleCloudPaymentsResellerSubscriptionV1Subscription struct { // CancellationDetails: Output only. Describes the details of a // cancelled subscription. Only applicable to subscription of state @@ -1000,8 +1000,11 @@ func (s *GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetail } // GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem: -// Individual line item definition of a subscription. Next id: 5 +// Individual line item definition of a subscription. Next id: 6 type GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem struct { + // Description: Output only. Description of this line item. + Description string `json:"description,omitempty"` + // LineItemFreeTrialEndTime: Output only. It is set only if the line // item has its own free trial applied. End time of the line item free // trial period, in ISO 8061 format. For example, @@ -1036,22 +1039,20 @@ type GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem struct { // deactivated. State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "LineItemFreeTrialEndTime") 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. "Description") 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. "LineItemFreeTrialEndTime") - // 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. "Description") 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/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 8d4d1f201c7..f1fbd6c3071 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -3058,7 +3058,7 @@ } } }, - "revision": "20220520", + "revision": "20220602", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3261,18 +3261,18 @@ "id": "Compliance", "properties": { "ids": { - "description": "e.g. A.12.4.1", + "description": "Policies within the standard/benchmark e.g. A.12.4.1", "items": { "type": "string" }, "type": "array" }, "standard": { - "description": "e.g. \"cis\", \"pci\", \"owasp\", etc.", + "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.", "type": "string" }, "version": { - "description": "e.g. 1.1", + "description": "Version of the standard/benchmark e.g. 1.1", "type": "string" } }, @@ -3517,7 +3517,7 @@ "type": "object" }, "EnvironmentVariable": { - "description": "EnvironmentVariable is a name-value pair to store env variables for Process.", + "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.", "id": "EnvironmentVariable", "properties": { "name": { @@ -3543,25 +3543,25 @@ "type": "array" }, "name": { - "description": "Resource’s URI (https://google.aip.dev/122#full-resource-names)", + "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)", "type": "string" } }, "type": "object" }, "Exfiltration": { - "description": "Exfiltration represents a data exfiltration attempt of one or more source(s) to one or more target(s). Source(s) represent the source of data that is exfiltrated, and Target(s) represents the destination the data was copied to.", + "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.", "id": "Exfiltration", "properties": { "sources": { - "description": "If there are multiple sources, then the data is considered “joined” between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.", + "description": "If there are multiple sources, then the data is considered \"joined\" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.", "items": { "$ref": "ExfilResource" }, "type": "array" }, "targets": { - "description": "If there are multiple targets, each target would get a complete copy of the “joined” source data.", + "description": "If there are multiple targets, each target would get a complete copy of the \"joined\" source data.", "items": { "$ref": "ExfilResource" }, @@ -3615,7 +3615,7 @@ "type": "string" }, "sha256": { - "description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, hash_sha256 represents the SHA256 hash of the entire file.", + "description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, sha256 represents the SHA256 hash of the entire file.", "type": "string" }, "size": { @@ -3680,7 +3680,7 @@ }, "exfiltration": { "$ref": "Exfiltration", - "description": "Represents exfiltrations associated with the Finding." + "description": "Represents exfiltration associated with the Finding." }, "externalSystems": { "additionalProperties": { @@ -5098,7 +5098,7 @@ "type": "array" }, "argumentsTruncated": { - "description": "True if arguments is incomplete.", + "description": "True if `args` is incomplete.", "type": "boolean" }, "binary": { @@ -5113,7 +5113,7 @@ "type": "array" }, "envVariablesTruncated": { - "description": "True if env_variables is incomplete.", + "description": "True if `env_variables` is incomplete.", "type": "boolean" }, "libraries": { @@ -5135,7 +5135,7 @@ }, "script": { "$ref": "File", - "description": "When the process represents the invocation of a script, binary provides information about the interpreter while script provides information about the script file provided to the interpreter." + "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter." } }, "type": "object" diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 60ab3c5a89d..0ad1caa3e60 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -826,13 +826,14 @@ func (s *BulkMuteFindingsRequest) MarshalJSON() ([]byte, error) { // Compliance: Contains compliance information about a security standard // indicating unmet recommendations. type Compliance struct { - // Ids: e.g. A.12.4.1 + // Ids: Policies within the standard/benchmark e.g. A.12.4.1 Ids []string `json:"ids,omitempty"` - // Standard: e.g. "cis", "pci", "owasp", etc. + // Standard: Refers to industry wide standards or benchmarks e.g. "cis", + // "pci", "owasp", etc. Standard string `json:"standard,omitempty"` - // Version: e.g. 1.1 + // Version: Version of the standard/benchmark e.g. 1.1 Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Ids") to @@ -1175,7 +1176,7 @@ type Empty struct { } // EnvironmentVariable: EnvironmentVariable is a name-value pair to -// store env variables for Process. +// store environment variables for Process. type EnvironmentVariable struct { // Name: Environment variable name as a JSON encoded string. Name string `json:"name,omitempty"` @@ -1215,8 +1216,7 @@ type ExfilResource struct { // Storage bucket. Components []string `json:"components,omitempty"` - // Name: Resource’s URI - // (https://google.aip.dev/122#full-resource-names) + // Name: Resource's URI (https://google.aip.dev/122#full-resource-names) Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Components") to @@ -1243,17 +1243,17 @@ func (s *ExfilResource) MarshalJSON() ([]byte, error) { } // Exfiltration: Exfiltration represents a data exfiltration attempt of -// one or more source(s) to one or more target(s). Source(s) represent -// the source of data that is exfiltrated, and Target(s) represents the +// one or more sources to one or more targets. Sources represent the +// source of data that is exfiltrated, and Targets represents the // destination the data was copied to. type Exfiltration struct { // Sources: If there are multiple sources, then the data is considered - // “joined” between them. For instance, BigQuery can join multiple + // "joined" between them. For instance, BigQuery can join multiple // tables, and each table would be considered a source. Sources []*ExfilResource `json:"sources,omitempty"` // Targets: If there are multiple targets, each target would get a - // complete copy of the “joined” source data. + // complete copy of the "joined" source data. Targets []*ExfilResource `json:"targets,omitempty"` // ForceSendFields is a list of field names (e.g. "Sources") to @@ -1358,8 +1358,8 @@ type File struct { Path string `json:"path,omitempty"` // Sha256: SHA256 hash of the first hashed_size bytes of the file - // encoded as a hex string. If hashed_size == size, hash_sha256 - // represents the SHA256 hash of the entire file. + // encoded as a hex string. If hashed_size == size, sha256 represents + // the SHA256 hash of the entire file. Sha256 string `json:"sha256,omitempty"` // Size: Size of the file in bytes. @@ -1447,7 +1447,7 @@ type Finding struct { // must not be set to a value greater than the current timestamp. EventTime string `json:"eventTime,omitempty"` - // Exfiltration: Represents exfiltrations associated with the Finding. + // Exfiltration: Represents exfiltration associated with the Finding. Exfiltration *Exfiltration `json:"exfiltration,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within @@ -3731,7 +3731,7 @@ type Process struct { // Args: Process arguments as JSON encoded strings. Args []string `json:"args,omitempty"` - // ArgumentsTruncated: True if arguments is incomplete. + // ArgumentsTruncated: True if `args` is incomplete. ArgumentsTruncated bool `json:"argumentsTruncated,omitempty"` // Binary: File information for the process executable. @@ -3740,7 +3740,7 @@ type Process struct { // EnvVariables: Process environment variables. EnvVariables []*EnvironmentVariable `json:"envVariables,omitempty"` - // EnvVariablesTruncated: True if env_variables is incomplete. + // EnvVariablesTruncated: True if `env_variables` is incomplete. EnvVariablesTruncated bool `json:"envVariablesTruncated,omitempty"` // Libraries: File information for libraries loaded by the process. @@ -3753,7 +3753,7 @@ type Process struct { Pid int64 `json:"pid,omitempty,string"` // Script: When the process represents the invocation of a script, - // binary provides information about the interpreter while script + // `binary` provides information about the interpreter while `script` // provides information about the script file provided to the // interpreter. Script *File `json:"script,omitempty"` diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index ac59892ec69..e9c088c0e2a 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -896,7 +896,7 @@ } } }, - "revision": "20220520", + "revision": "20220602", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1075,18 +1075,18 @@ "id": "Compliance", "properties": { "ids": { - "description": "e.g. A.12.4.1", + "description": "Policies within the standard/benchmark e.g. A.12.4.1", "items": { "type": "string" }, "type": "array" }, "standard": { - "description": "e.g. \"cis\", \"pci\", \"owasp\", etc.", + "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.", "type": "string" }, "version": { - "description": "e.g. 1.1", + "description": "Version of the standard/benchmark e.g. 1.1", "type": "string" } }, @@ -1331,7 +1331,7 @@ "type": "object" }, "EnvironmentVariable": { - "description": "EnvironmentVariable is a name-value pair to store env variables for Process.", + "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.", "id": "EnvironmentVariable", "properties": { "name": { @@ -1357,25 +1357,25 @@ "type": "array" }, "name": { - "description": "Resource’s URI (https://google.aip.dev/122#full-resource-names)", + "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)", "type": "string" } }, "type": "object" }, "Exfiltration": { - "description": "Exfiltration represents a data exfiltration attempt of one or more source(s) to one or more target(s). Source(s) represent the source of data that is exfiltrated, and Target(s) represents the destination the data was copied to.", + "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.", "id": "Exfiltration", "properties": { "sources": { - "description": "If there are multiple sources, then the data is considered “joined” between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.", + "description": "If there are multiple sources, then the data is considered \"joined\" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.", "items": { "$ref": "ExfilResource" }, "type": "array" }, "targets": { - "description": "If there are multiple targets, each target would get a complete copy of the “joined” source data.", + "description": "If there are multiple targets, each target would get a complete copy of the \"joined\" source data.", "items": { "$ref": "ExfilResource" }, @@ -1429,7 +1429,7 @@ "type": "string" }, "sha256": { - "description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, hash_sha256 represents the SHA256 hash of the entire file.", + "description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, sha256 represents the SHA256 hash of the entire file.", "type": "string" }, "size": { @@ -1494,7 +1494,7 @@ }, "exfiltration": { "$ref": "Exfiltration", - "description": "Represents exfiltrations associated with the Finding." + "description": "Represents exfiltration associated with the Finding." }, "externalSystems": { "additionalProperties": { @@ -2853,7 +2853,7 @@ "type": "array" }, "argumentsTruncated": { - "description": "True if arguments is incomplete.", + "description": "True if `args` is incomplete.", "type": "boolean" }, "binary": { @@ -2868,7 +2868,7 @@ "type": "array" }, "envVariablesTruncated": { - "description": "True if env_variables is incomplete.", + "description": "True if `env_variables` is incomplete.", "type": "boolean" }, "libraries": { @@ -2890,7 +2890,7 @@ }, "script": { "$ref": "File", - "description": "When the process represents the invocation of a script, binary provides information about the interpreter while script provides information about the script file provided to the interpreter." + "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter." } }, "type": "object" diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 4abcf9b9594..7111ad41595 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -517,13 +517,14 @@ type CancelOperationRequest struct { // Compliance: Contains compliance information about a security standard // indicating unmet recommendations. type Compliance struct { - // Ids: e.g. A.12.4.1 + // Ids: Policies within the standard/benchmark e.g. A.12.4.1 Ids []string `json:"ids,omitempty"` - // Standard: e.g. "cis", "pci", "owasp", etc. + // Standard: Refers to industry wide standards or benchmarks e.g. "cis", + // "pci", "owasp", etc. Standard string `json:"standard,omitempty"` - // Version: e.g. 1.1 + // Version: Version of the standard/benchmark e.g. 1.1 Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Ids") to @@ -866,7 +867,7 @@ type Empty struct { } // EnvironmentVariable: EnvironmentVariable is a name-value pair to -// store env variables for Process. +// store environment variables for Process. type EnvironmentVariable struct { // Name: Environment variable name as a JSON encoded string. Name string `json:"name,omitempty"` @@ -906,8 +907,7 @@ type ExfilResource struct { // Storage bucket. Components []string `json:"components,omitempty"` - // Name: Resource’s URI - // (https://google.aip.dev/122#full-resource-names) + // Name: Resource's URI (https://google.aip.dev/122#full-resource-names) Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Components") to @@ -934,17 +934,17 @@ func (s *ExfilResource) MarshalJSON() ([]byte, error) { } // Exfiltration: Exfiltration represents a data exfiltration attempt of -// one or more source(s) to one or more target(s). Source(s) represent -// the source of data that is exfiltrated, and Target(s) represents the +// one or more sources to one or more targets. Sources represent the +// source of data that is exfiltrated, and Targets represents the // destination the data was copied to. type Exfiltration struct { // Sources: If there are multiple sources, then the data is considered - // “joined” between them. For instance, BigQuery can join multiple + // "joined" between them. For instance, BigQuery can join multiple // tables, and each table would be considered a source. Sources []*ExfilResource `json:"sources,omitempty"` // Targets: If there are multiple targets, each target would get a - // complete copy of the “joined” source data. + // complete copy of the "joined" source data. Targets []*ExfilResource `json:"targets,omitempty"` // ForceSendFields is a list of field names (e.g. "Sources") to @@ -1049,8 +1049,8 @@ type File struct { Path string `json:"path,omitempty"` // Sha256: SHA256 hash of the first hashed_size bytes of the file - // encoded as a hex string. If hashed_size == size, hash_sha256 - // represents the SHA256 hash of the entire file. + // encoded as a hex string. If hashed_size == size, sha256 represents + // the SHA256 hash of the entire file. Sha256 string `json:"sha256,omitempty"` // Size: Size of the file in bytes. @@ -1138,7 +1138,7 @@ type Finding struct { // must not be set to a value greater than the current timestamp. EventTime string `json:"eventTime,omitempty"` - // Exfiltration: Represents exfiltrations associated with the Finding. + // Exfiltration: Represents exfiltration associated with the Finding. Exfiltration *Exfiltration `json:"exfiltration,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within @@ -3230,7 +3230,7 @@ type Process struct { // Args: Process arguments as JSON encoded strings. Args []string `json:"args,omitempty"` - // ArgumentsTruncated: True if arguments is incomplete. + // ArgumentsTruncated: True if `args` is incomplete. ArgumentsTruncated bool `json:"argumentsTruncated,omitempty"` // Binary: File information for the process executable. @@ -3239,7 +3239,7 @@ type Process struct { // EnvVariables: Process environment variables. EnvVariables []*EnvironmentVariable `json:"envVariables,omitempty"` - // EnvVariablesTruncated: True if env_variables is incomplete. + // EnvVariablesTruncated: True if `env_variables` is incomplete. EnvVariablesTruncated bool `json:"envVariablesTruncated,omitempty"` // Libraries: File information for libraries loaded by the process. @@ -3252,7 +3252,7 @@ type Process struct { Pid int64 `json:"pid,omitempty,string"` // Script: When the process represents the invocation of a script, - // binary provides information about the interpreter while script + // `binary` provides information about the interpreter while `script` // provides information about the script file provided to the // interpreter. Script *File `json:"script,omitempty"` diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index f6d05516676..44026016b02 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -1717,7 +1717,7 @@ } } }, - "revision": "20220520", + "revision": "20220602", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1756,18 +1756,18 @@ "id": "Compliance", "properties": { "ids": { - "description": "e.g. A.12.4.1", + "description": "Policies within the standard/benchmark e.g. A.12.4.1", "items": { "type": "string" }, "type": "array" }, "standard": { - "description": "e.g. \"cis\", \"pci\", \"owasp\", etc.", + "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.", "type": "string" }, "version": { - "description": "e.g. 1.1", + "description": "Version of the standard/benchmark e.g. 1.1", "type": "string" } }, @@ -2117,7 +2117,7 @@ "type": "object" }, "EnvironmentVariable": { - "description": "EnvironmentVariable is a name-value pair to store env variables for Process.", + "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.", "id": "EnvironmentVariable", "properties": { "name": { @@ -2183,25 +2183,25 @@ "type": "array" }, "name": { - "description": "Resource’s URI (https://google.aip.dev/122#full-resource-names)", + "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)", "type": "string" } }, "type": "object" }, "Exfiltration": { - "description": "Exfiltration represents a data exfiltration attempt of one or more source(s) to one or more target(s). Source(s) represent the source of data that is exfiltrated, and Target(s) represents the destination the data was copied to.", + "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.", "id": "Exfiltration", "properties": { "sources": { - "description": "If there are multiple sources, then the data is considered “joined” between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.", + "description": "If there are multiple sources, then the data is considered \"joined\" between them. For instance, BigQuery can join multiple tables, and each table would be considered a source.", "items": { "$ref": "ExfilResource" }, "type": "array" }, "targets": { - "description": "If there are multiple targets, each target would get a complete copy of the “joined” source data.", + "description": "If there are multiple targets, each target would get a complete copy of the \"joined\" source data.", "items": { "$ref": "ExfilResource" }, @@ -2232,7 +2232,7 @@ "type": "string" }, "sha256": { - "description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, hash_sha256 represents the SHA256 hash of the entire file.", + "description": "SHA256 hash of the first hashed_size bytes of the file encoded as a hex string. If hashed_size == size, sha256 represents the SHA256 hash of the entire file.", "type": "string" }, "size": { @@ -2297,7 +2297,7 @@ }, "exfiltration": { "$ref": "Exfiltration", - "description": "Represents exfiltrations associated with the Finding." + "description": "Represents exfiltration associated with the Finding." }, "externalSystems": { "additionalProperties": { @@ -3243,7 +3243,7 @@ "type": "array" }, "argumentsTruncated": { - "description": "True if arguments is incomplete.", + "description": "True if `args` is incomplete.", "type": "boolean" }, "binary": { @@ -3258,7 +3258,7 @@ "type": "array" }, "envVariablesTruncated": { - "description": "True if env_variables is incomplete.", + "description": "True if `env_variables` is incomplete.", "type": "boolean" }, "libraries": { @@ -3280,7 +3280,7 @@ }, "script": { "$ref": "File", - "description": "When the process represents the invocation of a script, binary provides information about the interpreter while script provides information about the script file provided to the interpreter." + "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter." } }, "type": "object" diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index e8ac212caaa..5d2290c87b9 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -436,13 +436,14 @@ func (s *Access) MarshalJSON() ([]byte, error) { // Compliance: Contains compliance information about a security standard // indicating unmet recommendations. type Compliance struct { - // Ids: e.g. A.12.4.1 + // Ids: Policies within the standard/benchmark e.g. A.12.4.1 Ids []string `json:"ids,omitempty"` - // Standard: e.g. "cis", "pci", "owasp", etc. + // Standard: Refers to industry wide standards or benchmarks e.g. "cis", + // "pci", "owasp", etc. Standard string `json:"standard,omitempty"` - // Version: e.g. 1.1 + // Version: Version of the standard/benchmark e.g. 1.1 Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Ids") to @@ -922,7 +923,7 @@ func (s *Details) MarshalJSON() ([]byte, error) { } // EnvironmentVariable: EnvironmentVariable is a name-value pair to -// store env variables for Process. +// store environment variables for Process. type EnvironmentVariable struct { // Name: Environment variable name as a JSON encoded string. Name string `json:"name,omitempty"` @@ -1018,8 +1019,7 @@ type ExfilResource struct { // Storage bucket. Components []string `json:"components,omitempty"` - // Name: Resource’s URI - // (https://google.aip.dev/122#full-resource-names) + // Name: Resource's URI (https://google.aip.dev/122#full-resource-names) Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Components") to @@ -1046,17 +1046,17 @@ func (s *ExfilResource) MarshalJSON() ([]byte, error) { } // Exfiltration: Exfiltration represents a data exfiltration attempt of -// one or more source(s) to one or more target(s). Source(s) represent -// the source of data that is exfiltrated, and Target(s) represents the +// one or more sources to one or more targets. Sources represent the +// source of data that is exfiltrated, and Targets represents the // destination the data was copied to. type Exfiltration struct { // Sources: If there are multiple sources, then the data is considered - // “joined” between them. For instance, BigQuery can join multiple + // "joined" between them. For instance, BigQuery can join multiple // tables, and each table would be considered a source. Sources []*ExfilResource `json:"sources,omitempty"` // Targets: If there are multiple targets, each target would get a - // complete copy of the “joined” source data. + // complete copy of the "joined" source data. Targets []*ExfilResource `json:"targets,omitempty"` // ForceSendFields is a list of field names (e.g. "Sources") to @@ -1101,8 +1101,8 @@ type File struct { Path string `json:"path,omitempty"` // Sha256: SHA256 hash of the first hashed_size bytes of the file - // encoded as a hex string. If hashed_size == size, hash_sha256 - // represents the SHA256 hash of the entire file. + // encoded as a hex string. If hashed_size == size, sha256 represents + // the SHA256 hash of the entire file. Sha256 string `json:"sha256,omitempty"` // Size: Size of the file in bytes. @@ -1190,7 +1190,7 @@ type Finding struct { // must not be set to a value greater than the current timestamp. EventTime string `json:"eventTime,omitempty"` - // Exfiltration: Represents exfiltrations associated with the Finding. + // Exfiltration: Represents exfiltration associated with the Finding. Exfiltration *Exfiltration `json:"exfiltration,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within @@ -2430,7 +2430,7 @@ type Process struct { // Args: Process arguments as JSON encoded strings. Args []string `json:"args,omitempty"` - // ArgumentsTruncated: True if arguments is incomplete. + // ArgumentsTruncated: True if `args` is incomplete. ArgumentsTruncated bool `json:"argumentsTruncated,omitempty"` // Binary: File information for the process executable. @@ -2439,7 +2439,7 @@ type Process struct { // EnvVariables: Process environment variables. EnvVariables []*EnvironmentVariable `json:"envVariables,omitempty"` - // EnvVariablesTruncated: True if env_variables is incomplete. + // EnvVariablesTruncated: True if `env_variables` is incomplete. EnvVariablesTruncated bool `json:"envVariablesTruncated,omitempty"` // Libraries: File information for libraries loaded by the process. @@ -2452,7 +2452,7 @@ type Process struct { Pid int64 `json:"pid,omitempty,string"` // Script: When the process represents the invocation of a script, - // binary provides information about the interpreter while script + // `binary` provides information about the interpreter while `script` // provides information about the script file provided to the // interpreter. Script *File `json:"script,omitempty"`