From 0d002f9b0a70e0e144940c9812a6ebee6e4aa9b7 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 17 Jan 2024 00:24:15 -0800 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2354) --- .../v1alpha/analyticsadmin-api.json | 271 ++++- analyticsadmin/v1alpha/analyticsadmin-gen.go | 953 ++++++++++++++++++ apigee/v1/apigee-api.json | 102 +- apigee/v1/apigee-gen.go | 489 ++++++++- bigquery/v2/bigquery-api.json | 37 +- bigquery/v2/bigquery-gen.go | 127 ++- .../v1/bigqueryconnection-api.json | 4 +- .../v1/bigqueryconnection-gen.go | 40 +- .../v1beta1/bigqueryconnection-api.json | 4 +- .../v1beta1/bigqueryconnection-gen.go | 40 +- chat/v1/chat-api.json | 126 +-- chat/v1/chat-gen.go | 415 +++++--- compute/v0.alpha/compute-api.json | 183 +--- compute/v0.alpha/compute-gen.go | 543 +--------- .../v1alpha/discoveryengine-api.json | 8 +- .../v1alpha/discoveryengine-gen.go | 1 + .../v1beta/discoveryengine-api.json | 8 +- discoveryengine/v1beta/discoveryengine-gen.go | 1 + documentai/v1/documentai-api.json | 20 +- documentai/v1/documentai-gen.go | 25 +- documentai/v1beta2/documentai-api.json | 4 +- documentai/v1beta2/documentai-gen.go | 4 +- documentai/v1beta3/documentai-api.json | 24 +- documentai/v1beta3/documentai-gen.go | 33 +- monitoring/v1/monitoring-api.json | 32 +- monitoring/v1/monitoring-gen.go | 71 +- .../v1alpha1/prod_tt_sasportal-api.json | 49 +- .../v1alpha1/prod_tt_sasportal-gen.go | 203 +++- .../v1/recaptchaenterprise-api.json | 50 +- .../v1/recaptchaenterprise-gen.go | 185 ++++ 30 files changed, 2992 insertions(+), 1060 deletions(-) diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index 00d8513db73..e2594899a4c 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -1775,6 +1775,165 @@ } } }, + "calculatedMetrics": { + "methods": { + "create": { + "description": "Creates a CalculatedMetric.", + "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics", + "httpMethod": "POST", + "id": "analyticsadmin.properties.calculatedMetrics.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "calculatedMetricId": { + "description": "Required. The ID to use for the calculated metric which will become the final component of the calculated metric's resource name. This value should be 1-80 characters and valid characters are /[a-zA-Z0-9_]/, no spaces allowed. calculated_metric_id must be unique between all calculated metrics under a property. The calculated_metric_id is used when referencing this calculated metric from external APIs, for example, \"calcMetric:{calculated_metric_id}\".", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Format: properties/{property_id} Example: properties/1234", + "location": "path", + "pattern": "^properties/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/calculatedMetrics", + "request": { + "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + }, + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + }, + "delete": { + "description": "Deletes a CalculatedMetric on a property.", + "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics/{calculatedMetricsId}", + "httpMethod": "DELETE", + "id": "analyticsadmin.properties.calculatedMetrics.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the CalculatedMetric to delete. Format: properties/{property_id}/calculatedMetrics/{calculated_metric_id} Example: properties/1234/calculatedMetrics/Metric01", + "location": "path", + "pattern": "^properties/[^/]+/calculatedMetrics/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + }, + "get": { + "description": "Lookup for a single CalculatedMetric.", + "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics/{calculatedMetricsId}", + "httpMethod": "GET", + "id": "analyticsadmin.properties.calculatedMetrics.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the CalculatedMetric to get. Format: properties/{property_id}/calculatedMetrics/{calculated_metric_id} Example: properties/1234/calculatedMetrics/Metric01", + "location": "path", + "pattern": "^properties/[^/]+/calculatedMetrics/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit", + "https://www.googleapis.com/auth/analytics.readonly" + ] + }, + "list": { + "description": "Lists CalculatedMetrics on a property.", + "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics", + "httpMethod": "GET", + "id": "analyticsadmin.properties.calculatedMetrics.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListCalculatedMetrics` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCalculatedMetrics` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Example format: properties/1234", + "location": "path", + "pattern": "^properties/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/calculatedMetrics", + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit", + "https://www.googleapis.com/auth/analytics.readonly" + ] + }, + "patch": { + "description": "Updates a CalculatedMetric on a property.", + "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics/{calculatedMetricsId}", + "httpMethod": "PATCH", + "id": "analyticsadmin.properties.calculatedMetrics.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name for this CalculatedMetric. Format: 'properties/{property_id}/calculatedMetrics/{calculated_metric_id}'", + "location": "path", + "pattern": "^properties/[^/]+/calculatedMetrics/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. The list of fields to be updated. 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": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + }, + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + } + } + }, "channelGroups": { "methods": { "create": { @@ -4298,7 +4457,7 @@ } } }, - "revision": "20240105", + "revision": "20240115", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { @@ -5444,6 +5603,88 @@ }, "type": "object" }, + "GoogleAnalyticsAdminV1alphaCalculatedMetric": { + "description": "A definition for a calculated metric.", + "id": "GoogleAnalyticsAdminV1alphaCalculatedMetric", + "properties": { + "calculatedMetricId": { + "description": "Output only. The ID to use for the calculated metric. In the UI, this is referred to as the \"API name.\" The calculated_metric_id is used when referencing this calculated metric from external APIs. For example, \"calcMetric:{calculated_metric_id}\".", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. Description for this calculated metric. Max length of 4096 characters.", + "type": "string" + }, + "displayName": { + "description": "Required. Display name for this calculated metric as shown in the Google Analytics UI. Max length 82 characters.", + "type": "string" + }, + "formula": { + "description": "Required. The calculated metric's definition. Maximum number of unique referenced custom metrics is 5. Formulas supports the following operations: + (addition), - (subtraction), - (negative), * (multiplication), / (division), () (parenthesis). Any valid real numbers are acceptable that fit in a Long (64bit integer) or a Double (64 bit floating point number). Example formula: \"( customEvent:parameter_name + cartPurchaseQuantity ) / 2.0\"", + "type": "string" + }, + "invalidMetricReference": { + "description": "Output only. If true, this calculated metric has a invalid metric reference. Anything using a calculated metric with invalid_metric_reference set to true may fail, produce warnings, or produce unexpected results.", + "readOnly": true, + "type": "boolean" + }, + "metricUnit": { + "description": "Required. The type for the calculated metric's value.", + "enum": [ + "METRIC_UNIT_UNSPECIFIED", + "STANDARD", + "CURRENCY", + "FEET", + "MILES", + "METERS", + "KILOMETERS", + "MILLISECONDS", + "SECONDS", + "MINUTES", + "HOURS" + ], + "enumDescriptions": [ + "MetricUnit unspecified or missing.", + "This metric uses default units.", + "This metric measures a currency.", + "This metric measures feet.", + "This metric measures miles.", + "This metric measures meters.", + "This metric measures kilometers.", + "This metric measures milliseconds.", + "This metric measures seconds.", + "This metric measures minutes.", + "This metric measures hours." + ], + "type": "string" + }, + "name": { + "description": "Output only. Resource name for this CalculatedMetric. Format: 'properties/{property_id}/calculatedMetrics/{calculated_metric_id}'", + "readOnly": true, + "type": "string" + }, + "restrictedMetricType": { + "description": "Output only. Types of restricted data that this metric contains.", + "items": { + "enum": [ + "RESTRICTED_METRIC_TYPE_UNSPECIFIED", + "COST_DATA", + "REVENUE_DATA" + ], + "enumDescriptions": [ + "Type unknown or unspecified.", + "Metric reports cost data.", + "Metric reports revenue data." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "GoogleAnalyticsAdminV1alphaCancelDisplayVideo360AdvertiserLinkProposalRequest": { "description": "Request message for CancelDisplayVideo360AdvertiserLinkProposal RPC.", "id": "GoogleAnalyticsAdminV1alphaCancelDisplayVideo360AdvertiserLinkProposalRequest", @@ -5509,6 +5750,10 @@ "$ref": "GoogleAnalyticsAdminV1alphaBigQueryLink", "description": "A snapshot of a BigQuery link resource in change history." }, + "calculatedMetric": { + "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric", + "description": "A snapshot of a CalculatedMetric resource in change history." + }, "channelGroup": { "$ref": "GoogleAnalyticsAdminV1alphaChannelGroup", "description": "A snapshot of a ChannelGroup resource in change history." @@ -7019,6 +7264,24 @@ }, "type": "object" }, + "GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse": { + "description": "Response message for ListCalculatedMetrics RPC.", + "id": "GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse", + "properties": { + "calculatedMetrics": { + "description": "List of CalculatedMetrics.", + "items": { + "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + } + }, + "type": "object" + }, "GoogleAnalyticsAdminV1alphaListChannelGroupsResponse": { "description": "Response message for ListChannelGroups RPC.", "id": "GoogleAnalyticsAdminV1alphaListChannelGroupsResponse", @@ -7955,7 +8218,8 @@ "SKADNETWORK_CONVERSION_VALUE_SCHEMA", "ADSENSE_LINK", "AUDIENCE", - "EVENT_CREATE_RULE" + "EVENT_CREATE_RULE", + "CALCULATED_METRIC" ], "enumDescriptions": [ "Resource type unknown or not specified.", @@ -7981,7 +8245,8 @@ "SKAdNetworkConversionValueSchema resource", "AdSenseLink resource", "Audience resource", - "EventCreateRule resource" + "EventCreateRule resource", + "CalculatedMetric resource" ], "type": "string" }, diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index 1779f8bba4d..67d0e345e46 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -213,6 +213,7 @@ func NewPropertiesService(s *Service) *PropertiesService { rs.AdSenseLinks = NewPropertiesAdSenseLinksService(s) rs.Audiences = NewPropertiesAudiencesService(s) rs.BigQueryLinks = NewPropertiesBigQueryLinksService(s) + rs.CalculatedMetrics = NewPropertiesCalculatedMetricsService(s) rs.ChannelGroups = NewPropertiesChannelGroupsService(s) rs.ConversionEvents = NewPropertiesConversionEventsService(s) rs.CustomDimensions = NewPropertiesCustomDimensionsService(s) @@ -240,6 +241,8 @@ type PropertiesService struct { BigQueryLinks *PropertiesBigQueryLinksService + CalculatedMetrics *PropertiesCalculatedMetricsService + ChannelGroups *PropertiesChannelGroupsService ConversionEvents *PropertiesConversionEventsService @@ -303,6 +306,15 @@ type PropertiesBigQueryLinksService struct { s *Service } +func NewPropertiesCalculatedMetricsService(s *Service) *PropertiesCalculatedMetricsService { + rs := &PropertiesCalculatedMetricsService{s: s} + return rs +} + +type PropertiesCalculatedMetricsService struct { + s *Service +} + func NewPropertiesChannelGroupsService(s *Service) *PropertiesChannelGroupsService { rs := &PropertiesChannelGroupsService{s: s} return rs @@ -2538,6 +2550,95 @@ func (s *GoogleAnalyticsAdminV1alphaBigQueryLink) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAnalyticsAdminV1alphaCalculatedMetric: A definition for a +// calculated metric. +type GoogleAnalyticsAdminV1alphaCalculatedMetric struct { + // CalculatedMetricId: Output only. The ID to use for the calculated + // metric. In the UI, this is referred to as the "API name." The + // calculated_metric_id is used when referencing this calculated metric + // from external APIs. For example, "calcMetric:{calculated_metric_id}". + CalculatedMetricId string `json:"calculatedMetricId,omitempty"` + + // Description: Optional. Description for this calculated metric. Max + // length of 4096 characters. + Description string `json:"description,omitempty"` + + // DisplayName: Required. Display name for this calculated metric as + // shown in the Google Analytics UI. Max length 82 characters. + DisplayName string `json:"displayName,omitempty"` + + // Formula: Required. The calculated metric's definition. Maximum number + // of unique referenced custom metrics is 5. Formulas supports the + // following operations: + (addition), - (subtraction), - (negative), * + // (multiplication), / (division), () (parenthesis). Any valid real + // numbers are acceptable that fit in a Long (64bit integer) or a Double + // (64 bit floating point number). Example formula: "( + // customEvent:parameter_name + cartPurchaseQuantity ) / 2.0" + Formula string `json:"formula,omitempty"` + + // InvalidMetricReference: Output only. If true, this calculated metric + // has a invalid metric reference. Anything using a calculated metric + // with invalid_metric_reference set to true may fail, produce warnings, + // or produce unexpected results. + InvalidMetricReference bool `json:"invalidMetricReference,omitempty"` + + // MetricUnit: Required. The type for the calculated metric's value. + // + // Possible values: + // "METRIC_UNIT_UNSPECIFIED" - MetricUnit unspecified or missing. + // "STANDARD" - This metric uses default units. + // "CURRENCY" - This metric measures a currency. + // "FEET" - This metric measures feet. + // "MILES" - This metric measures miles. + // "METERS" - This metric measures meters. + // "KILOMETERS" - This metric measures kilometers. + // "MILLISECONDS" - This metric measures milliseconds. + // "SECONDS" - This metric measures seconds. + // "MINUTES" - This metric measures minutes. + // "HOURS" - This metric measures hours. + MetricUnit string `json:"metricUnit,omitempty"` + + // Name: Output only. Resource name for this CalculatedMetric. Format: + // 'properties/{property_id}/calculatedMetrics/{calculated_metric_id}' + Name string `json:"name,omitempty"` + + // RestrictedMetricType: Output only. Types of restricted data that this + // metric contains. + // + // Possible values: + // "RESTRICTED_METRIC_TYPE_UNSPECIFIED" - Type unknown or unspecified. + // "COST_DATA" - Metric reports cost data. + // "REVENUE_DATA" - Metric reports revenue data. + RestrictedMetricType []string `json:"restrictedMetricType,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CalculatedMetricId") + // 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. "CalculatedMetricId") 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 *GoogleAnalyticsAdminV1alphaCalculatedMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaCalculatedMetric + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaCancelDisplayVideo360AdvertiserLinkProposal // Request: Request message for // CancelDisplayVideo360AdvertiserLinkProposal RPC. @@ -2614,6 +2715,10 @@ type GoogleAnalyticsAdminV1alphaChangeHistoryChangeChangeHistoryResource struct // history. BigqueryLink *GoogleAnalyticsAdminV1alphaBigQueryLink `json:"bigqueryLink,omitempty"` + // CalculatedMetric: A snapshot of a CalculatedMetric resource in change + // history. + CalculatedMetric *GoogleAnalyticsAdminV1alphaCalculatedMetric `json:"calculatedMetric,omitempty"` + // ChannelGroup: A snapshot of a ChannelGroup resource in change // history. ChannelGroup *GoogleAnalyticsAdminV1alphaChannelGroup `json:"channelGroup,omitempty"` @@ -5270,6 +5375,45 @@ func (s *GoogleAnalyticsAdminV1alphaListBigQueryLinksResponse) MarshalJSON() ([] return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse: Response +// message for ListCalculatedMetrics RPC. +type GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse struct { + // CalculatedMetrics: List of CalculatedMetrics. + CalculatedMetrics []*GoogleAnalyticsAdminV1alphaCalculatedMetric `json:"calculatedMetrics,omitempty"` + + // NextPageToken: A token, which can be sent as `page_token` to retrieve + // the next page. If this field is omitted, there are no subsequent + // pages. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CalculatedMetrics") + // 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. "CalculatedMetrics") 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 *GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaListChannelGroupsResponse: Response // message for ListChannelGroups RPC. type GoogleAnalyticsAdminV1alphaListChannelGroupsResponse struct { @@ -6918,6 +7062,7 @@ type GoogleAnalyticsAdminV1alphaSearchChangeHistoryEventsRequest struct { // "ADSENSE_LINK" - AdSenseLink resource // "AUDIENCE" - Audience resource // "EVENT_CREATE_RULE" - EventCreateRule resource + // "CALCULATED_METRIC" - CalculatedMetric resource ResourceType []string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -16439,6 +16584,814 @@ func (c *PropertiesBigQueryLinksListCall) Pages(ctx context.Context, f func(*Goo } } +// method id "analyticsadmin.properties.calculatedMetrics.create": + +type PropertiesCalculatedMetricsCreateCall struct { + s *Service + parent string + googleanalyticsadminv1alphacalculatedmetric *GoogleAnalyticsAdminV1alphaCalculatedMetric + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a CalculatedMetric. +// +// - parent: Format: properties/{property_id} Example: properties/1234. +func (r *PropertiesCalculatedMetricsService) Create(parent string, googleanalyticsadminv1alphacalculatedmetric *GoogleAnalyticsAdminV1alphaCalculatedMetric) *PropertiesCalculatedMetricsCreateCall { + c := &PropertiesCalculatedMetricsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleanalyticsadminv1alphacalculatedmetric = googleanalyticsadminv1alphacalculatedmetric + return c +} + +// CalculatedMetricId sets the optional parameter "calculatedMetricId": +// Required. The ID to use for the calculated metric which will become +// the final component of the calculated metric's resource name. This +// value should be 1-80 characters and valid characters are +// /[a-zA-Z0-9_]/, no spaces allowed. calculated_metric_id must be +// unique between all calculated metrics under a property. The +// calculated_metric_id is used when referencing this calculated metric +// from external APIs, for example, "calcMetric:{calculated_metric_id}". +func (c *PropertiesCalculatedMetricsCreateCall) CalculatedMetricId(calculatedMetricId string) *PropertiesCalculatedMetricsCreateCall { + c.urlParams_.Set("calculatedMetricId", calculatedMetricId) + 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 *PropertiesCalculatedMetricsCreateCall) Fields(s ...googleapi.Field) *PropertiesCalculatedMetricsCreateCall { + 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 *PropertiesCalculatedMetricsCreateCall) Context(ctx context.Context) *PropertiesCalculatedMetricsCreateCall { + 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 *PropertiesCalculatedMetricsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesCalculatedMetricsCreateCall) 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.googleanalyticsadminv1alphacalculatedmetric) + 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/{+parent}/calculatedMetrics") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.calculatedMetrics.create" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaCalculatedMetric or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaCalculatedMetric.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 *PropertiesCalculatedMetricsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaCalculatedMetric, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleAnalyticsAdminV1alphaCalculatedMetric{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a CalculatedMetric.", + // "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics", + // "httpMethod": "POST", + // "id": "analyticsadmin.properties.calculatedMetrics.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "calculatedMetricId": { + // "description": "Required. The ID to use for the calculated metric which will become the final component of the calculated metric's resource name. This value should be 1-80 characters and valid characters are /[a-zA-Z0-9_]/, no spaces allowed. calculated_metric_id must be unique between all calculated metrics under a property. The calculated_metric_id is used when referencing this calculated metric from external APIs, for example, \"calcMetric:{calculated_metric_id}\".", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Format: properties/{property_id} Example: properties/1234", + // "location": "path", + // "pattern": "^properties/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/calculatedMetrics", + // "request": { + // "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + // }, + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + +// method id "analyticsadmin.properties.calculatedMetrics.delete": + +type PropertiesCalculatedMetricsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a CalculatedMetric on a property. +// +// - name: The name of the CalculatedMetric to delete. Format: +// properties/{property_id}/calculatedMetrics/{calculated_metric_id} +// Example: properties/1234/calculatedMetrics/Metric01. +func (r *PropertiesCalculatedMetricsService) Delete(name string) *PropertiesCalculatedMetricsDeleteCall { + c := &PropertiesCalculatedMetricsDeleteCall{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 *PropertiesCalculatedMetricsDeleteCall) Fields(s ...googleapi.Field) *PropertiesCalculatedMetricsDeleteCall { + 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 *PropertiesCalculatedMetricsDeleteCall) Context(ctx context.Context) *PropertiesCalculatedMetricsDeleteCall { + 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 *PropertiesCalculatedMetricsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesCalculatedMetricsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.calculatedMetrics.delete" call. +// Exactly one of *GoogleProtobufEmpty or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *GoogleProtobufEmpty.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 *PropertiesCalculatedMetricsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleProtobufEmpty{ + 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": "Deletes a CalculatedMetric on a property.", + // "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics/{calculatedMetricsId}", + // "httpMethod": "DELETE", + // "id": "analyticsadmin.properties.calculatedMetrics.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the CalculatedMetric to delete. Format: properties/{property_id}/calculatedMetrics/{calculated_metric_id} Example: properties/1234/calculatedMetrics/Metric01", + // "location": "path", + // "pattern": "^properties/[^/]+/calculatedMetrics/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleProtobufEmpty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + +// method id "analyticsadmin.properties.calculatedMetrics.get": + +type PropertiesCalculatedMetricsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Lookup for a single CalculatedMetric. +// +// - name: The name of the CalculatedMetric to get. Format: +// properties/{property_id}/calculatedMetrics/{calculated_metric_id} +// Example: properties/1234/calculatedMetrics/Metric01. +func (r *PropertiesCalculatedMetricsService) Get(name string) *PropertiesCalculatedMetricsGetCall { + c := &PropertiesCalculatedMetricsGetCall{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 *PropertiesCalculatedMetricsGetCall) Fields(s ...googleapi.Field) *PropertiesCalculatedMetricsGetCall { + 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 *PropertiesCalculatedMetricsGetCall) IfNoneMatch(entityTag string) *PropertiesCalculatedMetricsGetCall { + 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 *PropertiesCalculatedMetricsGetCall) Context(ctx context.Context) *PropertiesCalculatedMetricsGetCall { + 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 *PropertiesCalculatedMetricsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesCalculatedMetricsGetCall) 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.calculatedMetrics.get" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaCalculatedMetric or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaCalculatedMetric.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 *PropertiesCalculatedMetricsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaCalculatedMetric, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleAnalyticsAdminV1alphaCalculatedMetric{ + 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 single CalculatedMetric.", + // "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics/{calculatedMetricsId}", + // "httpMethod": "GET", + // "id": "analyticsadmin.properties.calculatedMetrics.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the CalculatedMetric to get. Format: properties/{property_id}/calculatedMetrics/{calculated_metric_id} Example: properties/1234/calculatedMetrics/Metric01", + // "location": "path", + // "pattern": "^properties/[^/]+/calculatedMetrics/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit", + // "https://www.googleapis.com/auth/analytics.readonly" + // ] + // } + +} + +// method id "analyticsadmin.properties.calculatedMetrics.list": + +type PropertiesCalculatedMetricsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists CalculatedMetrics on a property. +// +// - parent: Example format: properties/1234. +func (r *PropertiesCalculatedMetricsService) List(parent string) *PropertiesCalculatedMetricsListCall { + c := &PropertiesCalculatedMetricsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of resources to return. If unspecified, at most 50 resources will be +// returned. The maximum value is 200 (higher values will be coerced to +// the maximum). +func (c *PropertiesCalculatedMetricsListCall) PageSize(pageSize int64) *PropertiesCalculatedMetricsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListCalculatedMetrics` call. Provide this +// to retrieve the subsequent page. When paginating, all other +// parameters provided to `ListCalculatedMetrics` must match the call +// that provided the page token. +func (c *PropertiesCalculatedMetricsListCall) PageToken(pageToken string) *PropertiesCalculatedMetricsListCall { + 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 *PropertiesCalculatedMetricsListCall) Fields(s ...googleapi.Field) *PropertiesCalculatedMetricsListCall { + 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 *PropertiesCalculatedMetricsListCall) IfNoneMatch(entityTag string) *PropertiesCalculatedMetricsListCall { + 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 *PropertiesCalculatedMetricsListCall) Context(ctx context.Context) *PropertiesCalculatedMetricsListCall { + 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 *PropertiesCalculatedMetricsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesCalculatedMetricsListCall) 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/{+parent}/calculatedMetrics") + 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 "analyticsadmin.properties.calculatedMetrics.list" call. +// Exactly one of +// *GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse.ServerRespon +// se.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 *PropertiesCalculatedMetricsListCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse{ + 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 CalculatedMetrics on a property.", + // "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics", + // "httpMethod": "GET", + // "id": "analyticsadmin.properties.calculatedMetrics.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. A page token, received from a previous `ListCalculatedMetrics` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCalculatedMetrics` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Example format: properties/1234", + // "location": "path", + // "pattern": "^properties/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/calculatedMetrics", + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit", + // "https://www.googleapis.com/auth/analytics.readonly" + // ] + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *PropertiesCalculatedMetricsListCall) Pages(ctx context.Context, f func(*GoogleAnalyticsAdminV1alphaListCalculatedMetricsResponse) 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 "analyticsadmin.properties.calculatedMetrics.patch": + +type PropertiesCalculatedMetricsPatchCall struct { + s *Service + name string + googleanalyticsadminv1alphacalculatedmetric *GoogleAnalyticsAdminV1alphaCalculatedMetric + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a CalculatedMetric on a property. +// +// - name: Output only. Resource name for this CalculatedMetric. Format: +// 'properties/{property_id}/calculatedMetrics/{calculated_metric_id}'. +func (r *PropertiesCalculatedMetricsService) Patch(name string, googleanalyticsadminv1alphacalculatedmetric *GoogleAnalyticsAdminV1alphaCalculatedMetric) *PropertiesCalculatedMetricsPatchCall { + c := &PropertiesCalculatedMetricsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleanalyticsadminv1alphacalculatedmetric = googleanalyticsadminv1alphacalculatedmetric + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to be updated. Omitted fields will not be updated. To +// replace the entire entity, use one path with the string "*" to match +// all fields. +func (c *PropertiesCalculatedMetricsPatchCall) UpdateMask(updateMask string) *PropertiesCalculatedMetricsPatchCall { + 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 *PropertiesCalculatedMetricsPatchCall) Fields(s ...googleapi.Field) *PropertiesCalculatedMetricsPatchCall { + 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 *PropertiesCalculatedMetricsPatchCall) Context(ctx context.Context) *PropertiesCalculatedMetricsPatchCall { + 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 *PropertiesCalculatedMetricsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesCalculatedMetricsPatchCall) 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.googleanalyticsadminv1alphacalculatedmetric) + 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.calculatedMetrics.patch" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaCalculatedMetric or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaCalculatedMetric.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 *PropertiesCalculatedMetricsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaCalculatedMetric, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleAnalyticsAdminV1alphaCalculatedMetric{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates a CalculatedMetric on a property.", + // "flatPath": "v1alpha/properties/{propertiesId}/calculatedMetrics/{calculatedMetricsId}", + // "httpMethod": "PATCH", + // "id": "analyticsadmin.properties.calculatedMetrics.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. Resource name for this CalculatedMetric. Format: 'properties/{property_id}/calculatedMetrics/{calculated_metric_id}'", + // "location": "path", + // "pattern": "^properties/[^/]+/calculatedMetrics/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. The list of fields to be updated. 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": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + // }, + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaCalculatedMetric" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + // method id "analyticsadmin.properties.channelGroups.create": type PropertiesChannelGroupsCreateCall struct { diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index ada74147b09..ba9e835410d 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -165,7 +165,7 @@ ] }, "delete": { - "description": "Delete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations, a soft-deletion is performed. The organization can be restored within the soft-deletion period which can be controlled using the retention field in the request.", + "description": "Delete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations (Subscription or Pay-as-you-go), a soft-deletion is performed. The organization can be restored within the soft-deletion period, which is specified using the `retention` field in the request or by filing a support ticket with Apigee. During the data retention period specified in the request, the Apigee organization cannot be recreated in the same Google Cloud project. **IMPORTANT: The default data retention setting for this operation is 7 days. To permanently delete the organization in 24 hours, set the retention parameter to `MINIMUM`.**", "flatPath": "v1/organizations/{organizationsId}", "httpMethod": "DELETE", "id": "apigee.organizations.delete", @@ -181,7 +181,7 @@ "type": "string" }, "retention": { - "description": "Optional. This setting is applicable only for organizations that are soft-deleted (i.e., BillingType is not EVALUATION). It controls how long Organization data will be retained after the initial delete operation completes. During this period, the Organization may be restored to its last known state. After this period, the Organization will no longer be able to be restored.", + "description": "Optional. This setting is applicable only for organizations that are soft-deleted (i.e., BillingType is not EVALUATION). It controls how long Organization data will be retained after the initial delete operation completes. During this period, the Organization may be restored to its last known state. After this period, the Organization will no longer be able to be restored. **Note: During the data retention period specified using this field, the Apigee organization cannot be recreated in the same GCP project.**", "enum": [ "DELETION_RETENTION_UNSPECIFIED", "MINIMUM" @@ -1523,6 +1523,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "update": { + "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", + "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", + "httpMethod": "PUT", + "id": "apigee.organizations.apis.keyvaluemaps.entries.update", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "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/[^/]+/entries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleCloudApigeeV1KeyValueEntry" + }, + "response": { + "$ref": "GoogleCloudApigeeV1KeyValueEntry" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -3095,7 +3123,7 @@ ], "parameters": { "parent": { - "description": "Parent of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps`", + "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "required": true, @@ -3297,7 +3325,7 @@ ], "parameters": { "parent": { - "description": "Parent of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps`", + "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "required": true, @@ -3746,7 +3774,7 @@ ], "parameters": { "name": { - "description": "ID of the environment group. Overrides any ID in the environment_group resource.", + "description": "Optional. ID of the environment group. Overrides any ID in the environment_group resource.", "location": "query", "type": "string" }, @@ -3912,7 +3940,7 @@ "type": "string" }, "updateMask": { - "description": "List of fields to be updated.", + "description": "Optional. List of fields to be updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -5944,6 +5972,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "update": { + "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", + "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", + "httpMethod": "PUT", + "id": "apigee.organizations.environments.keyvaluemaps.entries.update", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "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/[^/]+/entries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleCloudApigeeV1KeyValueEntry" + }, + "response": { + "$ref": "GoogleCloudApigeeV1KeyValueEntry" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -8681,6 +8737,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "update": { + "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", + "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", + "httpMethod": "PUT", + "id": "apigee.organizations.keyvaluemaps.entries.update", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "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/[^/]+/entries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleCloudApigeeV1KeyValueEntry" + }, + "response": { + "$ref": "GoogleCloudApigeeV1KeyValueEntry" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -9730,7 +9814,7 @@ } } }, - "revision": "20240108", + "revision": "20240112", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -16002,11 +16086,11 @@ "type": "object" }, "GoogleCloudApigeeV1SecurityActionConditionConfig": { - "description": "The following are a list of conditions. A valid SecurityAction must contain at least one condition. Within a condition, each element is ORed. Across conditions elements are ANDed. For example if a SecurityAction has the following: api_keys: [\"key1\", \"key2\"] and developers: [\"dev1\", \"dev2\"] then this is interpreted as: enforce the action if the incoming request has ((api_key = \"key1\" OR api_key=\"key\") AND (developer=\"dev1\" OR developer=\"dev2\"))", + "description": "The following are a list of conditions. A valid SecurityAction must contain at least one condition. Within a condition, each element is ORed. Across conditions elements are ANDed. For example if a SecurityAction has the following: api_keys: [\"key1\", \"key2\"] and developers: [\"dev1\", \"dev2\"] then this is interpreted as: enforce the action if the incoming request has ((api_key = \"key1\" OR api_key=\"key\") AND (developer=\"dev1\" OR developer=\"dev2\")).", "id": "GoogleCloudApigeeV1SecurityActionConditionConfig", "properties": { "botReasons": { - "description": "Optional. A list of Bot Reasons. Current options: Flooder, Brute Guessor, Static Content Scraper, OAuth Abuser, Robot Abuser, TorListRule, Advanced Anomaly Detection and Advanced API Scraper.", + "description": "Optional. A list of Bot Reasons. Current options: Flooder, Brute Guessor, Static Content Scraper, OAuth Abuser, Robot Abuser, TorListRule, Advanced Anomaly Detection, Advanced API Scraper, Search Engine Crawlers, Public Cloud, Public Cloud AWS, Public Cloud Azure, and Public Cloud GCP.", "items": { "type": "string" }, diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 7aca6978c37..c0854fd6065 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -10941,12 +10941,13 @@ type GoogleCloudApigeeV1SecurityActionAllow struct { // the following: api_keys: ["key1", "key2"] and developers: ["dev1", // "dev2"] then this is interpreted as: enforce the action if the // incoming request has ((api_key = "key1" OR api_key="key") AND -// (developer="dev1" OR developer="dev2")) +// (developer="dev1" OR developer="dev2")). type GoogleCloudApigeeV1SecurityActionConditionConfig struct { // BotReasons: Optional. A list of Bot Reasons. Current options: // Flooder, Brute Guessor, Static Content Scraper, OAuth Abuser, Robot - // Abuser, TorListRule, Advanced Anomaly Detection and Advanced API - // Scraper. + // Abuser, TorListRule, Advanced Anomaly Detection, Advanced API + // Scraper, Search Engine Crawlers, Public Cloud, Public Cloud AWS, + // Public Cloud Azure, and Public Cloud GCP. BotReasons []string `json:"botReasons,omitempty"` // IpAddressRanges: Optional. A list of IP addresses. This could be @@ -14002,9 +14003,15 @@ type OrganizationsDeleteCall struct { // Delete: Delete an Apigee organization. For organizations with // BillingType EVALUATION, an immediate deletion is performed. For paid -// organizations, a soft-deletion is performed. The organization can be -// restored within the soft-deletion period which can be controlled -// using the retention field in the request. +// organizations (Subscription or Pay-as-you-go), a soft-deletion is +// performed. The organization can be restored within the soft-deletion +// period, which is specified using the `retention` field in the request +// or by filing a support ticket with Apigee. During the data retention +// period specified in the request, the Apigee organization cannot be +// recreated in the same Google Cloud project. **IMPORTANT: The default +// data retention setting for this operation is 7 days. To permanently +// delete the organization in 24 hours, set the retention parameter to +// `MINIMUM`.** // // - name: Name of the organization. Use the following structure in your // request: `organizations/{org}`. @@ -14020,7 +14027,9 @@ func (r *OrganizationsService) Delete(name string) *OrganizationsDeleteCall { // data will be retained after the initial delete operation completes. // During this period, the Organization may be restored to its last // known state. After this period, the Organization will no longer be -// able to be restored. +// able to be restored. **Note: During the data retention period +// specified using this field, the Apigee organization cannot be +// recreated in the same GCP project.** // // Possible values: // @@ -14122,7 +14131,7 @@ func (c *OrganizationsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongr } return ret, nil // { - // "description": "Delete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations, a soft-deletion is performed. The organization can be restored within the soft-deletion period which can be controlled using the retention field in the request.", + // "description": "Delete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations (Subscription or Pay-as-you-go), a soft-deletion is performed. The organization can be restored within the soft-deletion period, which is specified using the `retention` field in the request or by filing a support ticket with Apigee. During the data retention period specified in the request, the Apigee organization cannot be recreated in the same Google Cloud project. **IMPORTANT: The default data retention setting for this operation is 7 days. To permanently delete the organization in 24 hours, set the retention parameter to `MINIMUM`.**", // "flatPath": "v1/organizations/{organizationsId}", // "httpMethod": "DELETE", // "id": "apigee.organizations.delete", @@ -14138,7 +14147,7 @@ func (c *OrganizationsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongr // "type": "string" // }, // "retention": { - // "description": "Optional. This setting is applicable only for organizations that are soft-deleted (i.e., BillingType is not EVALUATION). It controls how long Organization data will be retained after the initial delete operation completes. During this period, the Organization may be restored to its last known state. After this period, the Organization will no longer be able to be restored.", + // "description": "Optional. This setting is applicable only for organizations that are soft-deleted (i.e., BillingType is not EVALUATION). It controls how long Organization data will be retained after the initial delete operation completes. During this period, the Organization may be restored to its last known state. After this period, the Organization will no longer be able to be restored. **Note: During the data retention period specified using this field, the Apigee organization cannot be recreated in the same GCP project.**", // "enum": [ // "DELETION_RETENTION_UNSPECIFIED", // "MINIMUM" @@ -20999,6 +21008,156 @@ func (c *OrganizationsApisKeyvaluemapsEntriesListCall) Pages(ctx context.Context } } +// method id "apigee.organizations.apis.keyvaluemaps.entries.update": + +type OrganizationsApisKeyvaluemapsEntriesUpdateCall struct { + s *Service + name string + googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Update key value entry scoped to an organization, +// environment, or API proxy for an existing key. +// +// - name: 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}/keyvaluemap +// s/{keyvaluemap}` * +// `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. +func (r *OrganizationsApisKeyvaluemapsEntriesService) Update(name string, googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry) *OrganizationsApisKeyvaluemapsEntriesUpdateCall { + c := &OrganizationsApisKeyvaluemapsEntriesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudapigeev1keyvalueentry = googlecloudapigeev1keyvalueentry + 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 *OrganizationsApisKeyvaluemapsEntriesUpdateCall) Fields(s ...googleapi.Field) *OrganizationsApisKeyvaluemapsEntriesUpdateCall { + 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 *OrganizationsApisKeyvaluemapsEntriesUpdateCall) Context(ctx context.Context) *OrganizationsApisKeyvaluemapsEntriesUpdateCall { + 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 *OrganizationsApisKeyvaluemapsEntriesUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsApisKeyvaluemapsEntriesUpdateCall) 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.googlecloudapigeev1keyvalueentry) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PUT", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.apis.keyvaluemaps.entries.update" call. +// Exactly one of *GoogleCloudApigeeV1KeyValueEntry or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudApigeeV1KeyValueEntry.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 *OrganizationsApisKeyvaluemapsEntriesUpdateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1KeyValueEntry, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1KeyValueEntry{ + 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": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", + // "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", + // "httpMethod": "PUT", + // "id": "apigee.organizations.apis.keyvaluemaps.entries.update", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "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/[^/]+/entries/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "GoogleCloudApigeeV1KeyValueEntry" + // }, + // "response": { + // "$ref": "GoogleCloudApigeeV1KeyValueEntry" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "apigee.organizations.apis.revisions.delete": type OrganizationsApisRevisionsDeleteCall struct { @@ -28896,7 +29055,7 @@ type OrganizationsDevelopersAppsKeysCreateCall struct { // // - parent: Parent of the developer app key. Use the following // structure in your request: -// `organizations/{org}/developers/{developer_email}/apps`. +// 'organizations/{org}/developers/{developerEmail}/apps/{appName}'. func (r *OrganizationsDevelopersAppsKeysService) Create(parent string, googlecloudapigeev1developerappkey *GoogleCloudApigeeV1DeveloperAppKey) *OrganizationsDevelopersAppsKeysCreateCall { c := &OrganizationsDevelopersAppsKeysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -29005,7 +29164,7 @@ func (c *OrganizationsDevelopersAppsKeysCreateCall) Do(opts ...googleapi.CallOpt // ], // "parameters": { // "parent": { - // "description": "Parent of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps`", + // "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", // "location": "path", // "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", // "required": true, @@ -29960,7 +30119,7 @@ type OrganizationsDevelopersAppsKeysCreateCreateCall struct { // // - parent: Parent of the developer app key. Use the following // structure in your request: -// `organizations/{org}/developers/{developer_email}/apps`. +// 'organizations/{org}/developers/{developerEmail}/apps/{appName}'. func (r *OrganizationsDevelopersAppsKeysCreateService) Create(parent string, googlecloudapigeev1developerappkey *GoogleCloudApigeeV1DeveloperAppKey) *OrganizationsDevelopersAppsKeysCreateCreateCall { c := &OrganizationsDevelopersAppsKeysCreateCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -30069,7 +30228,7 @@ func (c *OrganizationsDevelopersAppsKeysCreateCreateCall) Do(opts ...googleapi.C // ], // "parameters": { // "parent": { - // "description": "Parent of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps`", + // "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", // "location": "path", // "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", // "required": true, @@ -32357,7 +32516,7 @@ func (c *OrganizationsEnvgroupsCreateCall) Do(opts ...googleapi.CallOption) (*Go // ], // "parameters": { // "name": { - // "description": "ID of the environment group. Overrides any ID in the environment_group resource.", + // "description": "Optional. ID of the environment group. Overrides any ID in the environment_group resource.", // "location": "query", // "type": "string" // }, @@ -33186,7 +33345,7 @@ func (c *OrganizationsEnvgroupsPatchCall) Do(opts ...googleapi.CallOption) (*Goo // "type": "string" // }, // "updateMask": { - // "description": "List of fields to be updated.", + // "description": "Optional. List of fields to be updated.", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -43582,6 +43741,156 @@ func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesListCall) Pages(ctx context } } +// method id "apigee.organizations.environments.keyvaluemaps.entries.update": + +type OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall struct { + s *Service + name string + googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Update key value entry scoped to an organization, +// environment, or API proxy for an existing key. +// +// - name: 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}/keyvaluemap +// s/{keyvaluemap}` * +// `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. +func (r *OrganizationsEnvironmentsKeyvaluemapsEntriesService) Update(name string, googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry) *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall { + c := &OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudapigeev1keyvalueentry = googlecloudapigeev1keyvalueentry + 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 *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall) Fields(s ...googleapi.Field) *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall { + 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 *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall) Context(ctx context.Context) *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall { + 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 *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall) 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.googlecloudapigeev1keyvalueentry) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PUT", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.environments.keyvaluemaps.entries.update" call. +// Exactly one of *GoogleCloudApigeeV1KeyValueEntry or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudApigeeV1KeyValueEntry.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 *OrganizationsEnvironmentsKeyvaluemapsEntriesUpdateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1KeyValueEntry, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1KeyValueEntry{ + 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": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", + // "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", + // "httpMethod": "PUT", + // "id": "apigee.organizations.environments.keyvaluemaps.entries.update", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "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/[^/]+/entries/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "GoogleCloudApigeeV1KeyValueEntry" + // }, + // "response": { + // "$ref": "GoogleCloudApigeeV1KeyValueEntry" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "apigee.organizations.environments.optimizedStats.get": type OrganizationsEnvironmentsOptimizedStatsGetCall struct { @@ -56941,6 +57250,156 @@ func (c *OrganizationsKeyvaluemapsEntriesListCall) Pages(ctx context.Context, f } } +// method id "apigee.organizations.keyvaluemaps.entries.update": + +type OrganizationsKeyvaluemapsEntriesUpdateCall struct { + s *Service + name string + googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Update key value entry scoped to an organization, +// environment, or API proxy for an existing key. +// +// - name: 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}/keyvaluemap +// s/{keyvaluemap}` * +// `organizations/{organization}/keyvaluemaps/{keyvaluemap}`. +func (r *OrganizationsKeyvaluemapsEntriesService) Update(name string, googlecloudapigeev1keyvalueentry *GoogleCloudApigeeV1KeyValueEntry) *OrganizationsKeyvaluemapsEntriesUpdateCall { + c := &OrganizationsKeyvaluemapsEntriesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudapigeev1keyvalueentry = googlecloudapigeev1keyvalueentry + 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 *OrganizationsKeyvaluemapsEntriesUpdateCall) Fields(s ...googleapi.Field) *OrganizationsKeyvaluemapsEntriesUpdateCall { + 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 *OrganizationsKeyvaluemapsEntriesUpdateCall) Context(ctx context.Context) *OrganizationsKeyvaluemapsEntriesUpdateCall { + 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 *OrganizationsKeyvaluemapsEntriesUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsKeyvaluemapsEntriesUpdateCall) 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.googlecloudapigeev1keyvalueentry) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PUT", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.keyvaluemaps.entries.update" call. +// Exactly one of *GoogleCloudApigeeV1KeyValueEntry or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudApigeeV1KeyValueEntry.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 *OrganizationsKeyvaluemapsEntriesUpdateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1KeyValueEntry, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1KeyValueEntry{ + 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": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", + // "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", + // "httpMethod": "PUT", + // "id": "apigee.organizations.keyvaluemaps.entries.update", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "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/[^/]+/entries/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "GoogleCloudApigeeV1KeyValueEntry" + // }, + // "response": { + // "$ref": "GoogleCloudApigeeV1KeyValueEntry" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "apigee.organizations.operations.get": type OrganizationsOperationsGetCall struct { diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index 709323a9727..1467eebba32 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1686,7 +1686,7 @@ } } }, - "revision": "20231202", + "revision": "20240105", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -2422,7 +2422,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 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. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `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.", + "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. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `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. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" }, @@ -5552,6 +5552,10 @@ "$ref": "QueryParameterType", "description": "[Optional] The type of the array's elements, if this is an array." }, + "rangeElementType": { + "$ref": "QueryParameterType", + "description": "[Optional] The element type of the range, if this is a range." + }, "structTypes": { "description": "[Optional] The types of the fields of this struct, in order, if this is a struct.", "items": { @@ -5590,6 +5594,18 @@ }, "type": "array" }, + "rangeValue": { + "description": "[Optional] The range value, if this is a range type.", + "properties": { + "end": { + "$ref": "QueryParameterValue" + }, + "start": { + "$ref": "QueryParameterValue" + } + }, + "type": "object" + }, "structValues": { "additionalProperties": { "$ref": "QueryParameterValue" @@ -5849,6 +5865,21 @@ }, "type": "object" }, + "RangeValue": { + "description": "Represents the value of a range.", + "id": "RangeValue", + "properties": { + "end": { + "$ref": "QueryParameterValue", + "description": "Optional. The end value of the range. A missing value represents an unbounded end." + }, + "start": { + "$ref": "QueryParameterValue", + "description": "Optional. The start value of the range. A missing value represents an unbounded start." + } + }, + "type": "object" + }, "RankingMetrics": { "description": "Evaluation metrics used by weighted-ALS models specified by feedback_type=implicit.", "id": "RankingMetrics", @@ -6129,7 +6160,7 @@ "description": "Optional. Spark specific options." }, "strictMode": { - "description": "Optional. Can be set for procedures only. If true (default), the definition body will be validated in the creation and the updates of the procedure. For procedures with an argument of ANY TYPE, the definition body validtion is not supported at creation/update time, and thus this field must be set to false explicitly.", + "description": "Optional. Use this option to catch many common errors. Error checking is not exhaustive, and successfully creating a procedure doesn't guarantee that the procedure will successfully execute at runtime. If `strictMode` is set to `TRUE`, the procedure body is further checked for errors such as non-existent tables or columns. The `CREATE PROCEDURE` statement fails if the body fails any of these checks. If `strictMode` is set to `FALSE`, the procedure body is checked only for syntax. For procedures that invoke themselves recursively, specify `strictMode=FALSE` to avoid non-existent procedure errors during validation. Default value is `TRUE`.", "type": "boolean" } }, diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 307ca3c296f..78b870b1eac 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1477,11 +1477,34 @@ type Binding struct { // For example, `admins@example.com`. * `domain:{domain}`: The G Suite // domain (primary) that represents all the users of that domain. For // example, `google.com` or `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. * + // `principal://iam.googleapis.com/locations/global/workforcePools/{pool_ + // id}/subject/{subject_attribute_value}`: A single identity in a + // workforce identity pool. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/group/{group_id}`: All workforce identities in a group. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/attribute.{attribute_name}/{attribute_value}`: All workforce + // identities with a specific attribute value. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/*`: All identities in a workforce identity pool. * + // `principal://iam.googleapis.com/projects/{project_number}/locations/gl + // obal/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value} + // `: A single identity in a workload identity pool. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload + // identity pool group. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{at + // tribute_value}`: All identities in a workload identity pool with a + // certain attribute. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/*`: All identities in a + // workload identity pool. * `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, @@ -1493,7 +1516,12 @@ type Binding struct { // 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. + // group retains the role in the binding. * + // `deleted:principal://iam.googleapis.com/locations/global/workforcePool + // s/{pool_id}/subject/{subject_attribute_value}`: Deleted single + // identity in a workforce identity pool. For example, + // `deleted:principal://iam.googleapis.com/locations/global/workforcePool + // s/my-pool-id/subject/my-subject-attribute-value`. Members []string `json:"members,omitempty"` // Role: Role that is assigned to the list of `members`, or principals. @@ -6716,6 +6744,10 @@ type QueryParameterType struct { // array. ArrayType *QueryParameterType `json:"arrayType,omitempty"` + // RangeElementType: [Optional] The element type of the range, if this + // is a range. + RangeElementType *QueryParameterType `json:"rangeElementType,omitempty"` + // StructTypes: [Optional] The types of the fields of this struct, in // order, if this is a struct. StructTypes []*QueryParameterTypeStructTypes `json:"structTypes,omitempty"` @@ -6783,6 +6815,9 @@ type QueryParameterValue struct { // ArrayValues: [Optional] The array values, if this is an array type. ArrayValues []*QueryParameterValue `json:"arrayValues,omitempty"` + // RangeValue: [Optional] The range value, if this is a range type. + RangeValue *QueryParameterValueRangeValue `json:"rangeValue,omitempty"` + // StructValues: [Optional] The struct field values, in order of the // struct type's declaration. StructValues map[string]QueryParameterValue `json:"structValues,omitempty"` @@ -6813,6 +6848,36 @@ func (s *QueryParameterValue) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// QueryParameterValueRangeValue: [Optional] The range value, if this is +// a range type. +type QueryParameterValueRangeValue struct { + End *QueryParameterValue `json:"end,omitempty"` + + Start *QueryParameterValue `json:"start,omitempty"` + + // ForceSendFields is a list of field names (e.g. "End") 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. "End") 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 *QueryParameterValueRangeValue) MarshalJSON() ([]byte, error) { + type NoMethod QueryParameterValueRangeValue + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type QueryRequest struct { // ConnectionProperties: Connection properties. ConnectionProperties []*ConnectionProperty `json:"connectionProperties,omitempty"` @@ -7186,6 +7251,39 @@ func (s *RangePartitioningRange) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RangeValue: Represents the value of a range. +type RangeValue struct { + // End: Optional. The end value of the range. A missing value represents + // an unbounded end. + End *QueryParameterValue `json:"end,omitempty"` + + // Start: Optional. The start value of the range. A missing value + // represents an unbounded start. + Start *QueryParameterValue `json:"start,omitempty"` + + // ForceSendFields is a list of field names (e.g. "End") 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. "End") 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 *RangeValue) MarshalJSON() ([]byte, error) { + type NoMethod RangeValue + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // RankingMetrics: Evaluation metrics used by weighted-ALS models // specified by feedback_type=implicit. type RankingMetrics struct { @@ -7567,12 +7665,17 @@ type Routine struct { // SparkOptions: Optional. Spark specific options. SparkOptions *SparkOptions `json:"sparkOptions,omitempty"` - // StrictMode: Optional. Can be set for procedures only. If true - // (default), the definition body will be validated in the creation and - // the updates of the procedure. For procedures with an argument of ANY - // TYPE, the definition body validtion is not supported at - // creation/update time, and thus this field must be set to false - // explicitly. + // StrictMode: Optional. Use this option to catch many common errors. + // Error checking is not exhaustive, and successfully creating a + // procedure doesn't guarantee that the procedure will successfully + // execute at runtime. If `strictMode` is set to `TRUE`, the procedure + // body is further checked for errors such as non-existent tables or + // columns. The `CREATE PROCEDURE` statement fails if the body fails any + // of these checks. If `strictMode` is set to `FALSE`, the procedure + // body is checked only for syntax. For procedures that invoke + // themselves recursively, specify `strictMode=FALSE` to avoid + // non-existent procedure errors during validation. Default value is + // `TRUE`. StrictMode bool `json:"strictMode,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/bigqueryconnection/v1/bigqueryconnection-api.json b/bigqueryconnection/v1/bigqueryconnection-api.json index 9d7475ca058..f58f6b8b1ee 100644 --- a/bigqueryconnection/v1/bigqueryconnection-api.json +++ b/bigqueryconnection/v1/bigqueryconnection-api.json @@ -366,7 +366,7 @@ } } }, - "revision": "20231203", + "revision": "20240106", "rootUrl": "https://bigqueryconnection.googleapis.com/", "schemas": { "AuditConfig": { @@ -491,7 +491,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 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. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `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.", + "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. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `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. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" }, diff --git a/bigqueryconnection/v1/bigqueryconnection-gen.go b/bigqueryconnection/v1/bigqueryconnection-gen.go index 315ac726891..dc2cdcde888 100644 --- a/bigqueryconnection/v1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1/bigqueryconnection-gen.go @@ -447,11 +447,34 @@ type Binding struct { // For example, `admins@example.com`. * `domain:{domain}`: The G Suite // domain (primary) that represents all the users of that domain. For // example, `google.com` or `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. * + // `principal://iam.googleapis.com/locations/global/workforcePools/{pool_ + // id}/subject/{subject_attribute_value}`: A single identity in a + // workforce identity pool. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/group/{group_id}`: All workforce identities in a group. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/attribute.{attribute_name}/{attribute_value}`: All workforce + // identities with a specific attribute value. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/*`: All identities in a workforce identity pool. * + // `principal://iam.googleapis.com/projects/{project_number}/locations/gl + // obal/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value} + // `: A single identity in a workload identity pool. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload + // identity pool group. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{at + // tribute_value}`: All identities in a workload identity pool with a + // certain attribute. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/*`: All identities in a + // workload identity pool. * `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, @@ -463,7 +486,12 @@ type Binding struct { // 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. + // group retains the role in the binding. * + // `deleted:principal://iam.googleapis.com/locations/global/workforcePool + // s/{pool_id}/subject/{subject_attribute_value}`: Deleted single + // identity in a workforce identity pool. For example, + // `deleted:principal://iam.googleapis.com/locations/global/workforcePool + // s/my-pool-id/subject/my-subject-attribute-value`. Members []string `json:"members,omitempty"` // Role: Role that is assigned to the list of `members`, or principals. diff --git a/bigqueryconnection/v1beta1/bigqueryconnection-api.json b/bigqueryconnection/v1beta1/bigqueryconnection-api.json index 415cf160320..0b2347da0dd 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-api.json +++ b/bigqueryconnection/v1beta1/bigqueryconnection-api.json @@ -395,7 +395,7 @@ } } }, - "revision": "20230806", + "revision": "20240106", "rootUrl": "https://bigqueryconnection.googleapis.com/", "schemas": { "AuditConfig": { @@ -455,7 +455,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 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. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `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.", + "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. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `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. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" }, diff --git a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go index 0c5bfcecd7c..1250b5f03e3 100644 --- a/bigqueryconnection/v1beta1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1beta1/bigqueryconnection-gen.go @@ -327,11 +327,34 @@ type Binding struct { // For example, `admins@example.com`. * `domain:{domain}`: The G Suite // domain (primary) that represents all the users of that domain. For // example, `google.com` or `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. * + // `principal://iam.googleapis.com/locations/global/workforcePools/{pool_ + // id}/subject/{subject_attribute_value}`: A single identity in a + // workforce identity pool. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/group/{group_id}`: All workforce identities in a group. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/attribute.{attribute_name}/{attribute_value}`: All workforce + // identities with a specific attribute value. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{po + // ol_id}/*`: All identities in a workforce identity pool. * + // `principal://iam.googleapis.com/projects/{project_number}/locations/gl + // obal/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value} + // `: A single identity in a workload identity pool. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload + // identity pool group. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{at + // tribute_value}`: All identities in a workload identity pool with a + // certain attribute. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations + // /global/workloadIdentityPools/{pool_id}/*`: All identities in a + // workload identity pool. * `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, @@ -343,7 +366,12 @@ type Binding struct { // 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. + // group retains the role in the binding. * + // `deleted:principal://iam.googleapis.com/locations/global/workforcePool + // s/{pool_id}/subject/{subject_attribute_value}`: Deleted single + // identity in a workforce identity pool. For example, + // `deleted:principal://iam.googleapis.com/locations/global/workforcePool + // s/my-pool-id/subject/my-subject-attribute-value`. Members []string `json:"members,omitempty"` // Role: Role that is assigned to the list of `members`, or principals. diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 89e0f90aa8c..e397c19b4f6 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -409,7 +409,7 @@ "type": "string" }, "updateMask": { - "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.)", + "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) - Developer Preview: `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of a space. If no audience is specified in the access setting, the space's access setting is updated to restricted. Warning: mutually exclusive with all other field paths.)", "format": "google-fieldmask", "location": "query", "type": "string" @@ -602,7 +602,7 @@ ], "parameters": { "messageId": { - "description": "Optional. A custom name for a Chat message assigned at creation. Must start with `client-` and contain only lowercase letters, numbers, and hyphens up to 63 characters in length. Specify this field to get, update, or delete the message with the specified value. Assigning a custom name lets a a Chat app recall the message without saving the message `name` from the [response body](/chat/api/reference/rest/v1/spaces.messages/get#response-body) returned when creating the message. Assigning a custom name doesn't replace the generated `name` field, the message's resource name. Instead, it sets the custom name as the `clientAssignedMessageId` field, which you can reference while processing later operations, like updating or deleting the message. For example usage, see [Name a created message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", + "description": "Optional. A custom ID for a message. Lets Chat apps get, update, or delete a message without needing to store the system-assigned ID in the message's resource name (represented in the message `name` field). The value for this field must meet the following requirements: * Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but `custom-name` is not. * Contains up to 63 characters and only lowercase letters, numbers, and hyphens. * Is unique within a space. A Chat app can't use the same custom ID for different messages. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "location": "query", "type": "string" }, @@ -669,7 +669,7 @@ "type": "boolean" }, "name": { - "description": "Required. Resource name of the message that you want to delete, in the form `spaces/*/messages/*` Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, @@ -696,7 +696,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name of the message to retrieve. Format: `spaces/{space}/messages/{message}` If the message begins with `client-`, then it has a custom name assigned by a Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", + "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, @@ -781,14 +781,14 @@ "type": "boolean" }, "name": { - "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", + "description": "Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - Developer Preview: `accessory_widgets` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", "format": "google-fieldmask", "location": "query", "type": "string" @@ -822,14 +822,14 @@ "type": "boolean" }, "name": { - "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", + "description": "Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - Developer Preview: `accessory_widgets` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", "format": "google-fieldmask", "location": "query", "type": "string" @@ -990,7 +990,7 @@ } } }, - "revision": "20240109", + "revision": "20240111", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -1348,7 +1348,7 @@ "type": "object" }, "ChatClientDataSourceMarkup": { - "description": "Chat apps only. For a `SelectionInput` widget that uses a multiselect menu, a data source from Google Chat. The data source populates selection items for the multiselect menu. For example, a user can select Google Chat spaces that they're a member of.", + "description": "For a `SelectionInput` widget that uses a multiselect menu, a data source from Google Chat. The data source populates selection items for the multiselect menu. For example, a user can select Google Chat spaces that they're a member of. [Google Chat apps](https://developers.google.com/chat):", "id": "ChatClientDataSourceMarkup", "properties": { "spaceDataSource": { @@ -1730,7 +1730,7 @@ "type": "object" }, "GoogleAppsCardV1Action": { - "description": "An action that describes the behavior when the form is submitted. For example, you can invoke an Apps Script script to handle the form. If the action is triggered, the form values are sent to the server.", + "description": "An action that describes the behavior when the form is submitted. For example, you can invoke an Apps Script script to handle the form. If the action is triggered, the form values are sent to the server. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Action", "properties": { "function": { @@ -1738,14 +1738,14 @@ "type": "string" }, "interaction": { - "description": "Optional. Required when opening a [dialog](https://developers.google.com/chat/how-tos/dialogs). What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an `action`—like opening a link or running a function—as normal. By specifying an `interaction`, the app can respond in special interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs). When specified, a loading indicator isn't shown. Supported by Chat apps, but not Google Workspace Add-ons. If specified for an add-on, the entire card is stripped and nothing is shown in the client.", + "description": "Optional. Required when opening a [dialog](https://developers.google.com/chat/how-tos/dialogs). What to do in response to an interaction with a user, such as a user clicking a button in a card message. If unspecified, the app responds by executing an `action`—like opening a link or running a function—as normal. By specifying an `interaction`, the app can respond in special interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs). When specified, a loading indicator isn't shown. If specified for an add-on, the entire card is stripped and nothing is shown in the client. [Google Chat apps](https://developers.google.com/chat):", "enum": [ "INTERACTION_UNSPECIFIED", "OPEN_DIALOG" ], "enumDescriptions": [ "Default value. The `action` executes as normal.", - "Opens a [dialog](https://developers.google.com/chat/how-tos/dialogs), a windowed, card-based interface that Chat apps use to interact with users. Only supported by Chat apps in response to button-clicks on card messages. Not supported by Google Workspace Add-ons. If specified for an add-on, the entire card is stripped and nothing is shown in the client." + "Opens a [dialog](https://developers.google.com/chat/how-tos/dialogs), a windowed, card-based interface that Chat apps use to interact with users. Only supported by Chat apps in response to button-clicks on card messages. If specified for an add-on, the entire card is stripped and nothing is shown in the client. [Google Chat apps](https://developers.google.com/chat):" ], "type": "string" }, @@ -1776,7 +1776,7 @@ "type": "object" }, "GoogleAppsCardV1ActionParameter": { - "description": "List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, or snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters. To learn more, see [`CommonEventObject`](https://developers.google.com/chat/api/reference/rest/v1/Event#commoneventobject).", + "description": "List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze one day, or snooze next week. You might use `action method = snooze()`, passing the snooze type and snooze time in the list of string parameters. To learn more, see [`CommonEventObject`](https://developers.google.com/chat/api/reference/rest/v1/Event#commoneventobject). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1ActionParameter", "properties": { "key": { @@ -1791,7 +1791,7 @@ "type": "object" }, "GoogleAppsCardV1BorderStyle": { - "description": "The style options for the border of a card or widget, including the border type and color.", + "description": "The style options for the border of a card or widget, including the border type and color. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1BorderStyle", "properties": { "cornerRadius": { @@ -1821,7 +1821,7 @@ "type": "object" }, "GoogleAppsCardV1Button": { - "description": "A text, icon, or text and icon button that users can click. For an example in Google Chat apps, see [Button list](https://developers.google.com/chat/ui/widgets/button-list). To make an image a clickable button, specify an `Image` (not an `ImageComponent`) and set an `onClick` action.", + "description": "A text, icon, or text and icon button that users can click. For an example in Google Chat apps, see [Button list](https://developers.google.com/chat/ui/widgets/button-list). To make an image a clickable button, specify an `Image` (not an `ImageComponent`) and set an `onClick` action. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Button", "properties": { "altText": { @@ -1852,7 +1852,7 @@ "type": "object" }, "GoogleAppsCardV1ButtonList": { - "description": "A list of buttons layed out horizontally. For an example in Google Chat apps, see [Button list](https://developers.google.com/chat/ui/widgets/button-list).", + "description": "A list of buttons layed out horizontally. For an example in Google Chat apps, see [Button list](https://developers.google.com/chat/ui/widgets/button-list). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1ButtonList", "properties": { "buttons": { @@ -1870,14 +1870,14 @@ "id": "GoogleAppsCardV1Card", "properties": { "cardActions": { - "description": "The card's actions. Actions are added to the card's toolbar menu. Because Chat app cards have no toolbar, `cardActions[]` isn't supported by Chat apps. For example, the following JSON constructs a card action menu with `Settings` and `Send Feedback` options: ``` \"card_actions\": [ { \"actionLabel\": \"Settings\", \"onClick\": { \"action\": { \"functionName\": \"goToView\", \"parameters\": [ { \"key\": \"viewType\", \"value\": \"SETTING\" } ], \"loadIndicator\": \"LoadIndicator.SPINNER\" } } }, { \"actionLabel\": \"Send Feedback\", \"onClick\": { \"openLink\": { \"url\": \"https://example.com/feedback\" } } } ] ```", + "description": "The card's actions. Actions are added to the card's toolbar menu. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons): For example, the following JSON constructs a card action menu with `Settings` and `Send Feedback` options: ``` \"card_actions\": [ { \"actionLabel\": \"Settings\", \"onClick\": { \"action\": { \"functionName\": \"goToView\", \"parameters\": [ { \"key\": \"viewType\", \"value\": \"SETTING\" } ], \"loadIndicator\": \"LoadIndicator.SPINNER\" } } }, { \"actionLabel\": \"Send Feedback\", \"onClick\": { \"openLink\": { \"url\": \"https://example.com/feedback\" } } } ] ```", "items": { "$ref": "GoogleAppsCardV1CardAction" }, "type": "array" }, "displayStyle": { - "description": "In Google Workspace add-ons, sets the display properties of the `peekCardHeader`. Not supported by Chat apps.", + "description": "In Google Workspace Add-ons, sets the display properties of the `peekCardHeader`. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):", "enum": [ "DISPLAY_STYLE_UNSPECIFIED", "PEEK", @@ -1892,19 +1892,19 @@ }, "fixedFooter": { "$ref": "GoogleAppsCardV1CardFixedFooter", - "description": "The fixed footer shown at the bottom of this card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. Supported by Google Workspace Add-ons and Chat apps. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create)." + "description": "The fixed footer shown at the bottom of this card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):" }, "header": { "$ref": "GoogleAppsCardV1CardHeader", "description": "The header of the card. A header usually contains a leading image and a title. Headers always appear at the top of a card." }, "name": { - "description": "Name of the card. Used as a card identifier in card navigation. Because Chat apps don't support card navigation, they ignore this field.", + "description": "Name of the card. Used as a card identifier in card navigation. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):", "type": "string" }, "peekCardHeader": { "$ref": "GoogleAppsCardV1CardHeader", - "description": "When displaying contextual content, the peek card header acts as a placeholder so that the user can navigate forward between the homepage cards and the contextual cards. Not supported by Chat apps." + "description": "When displaying contextual content, the peek card header acts as a placeholder so that the user can navigate forward between the homepage cards and the contextual cards. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):" }, "sectionDividerStyle": { "description": "The divider style between sections.", @@ -1946,7 +1946,7 @@ "type": "object" }, "GoogleAppsCardV1CardFixedFooter": { - "description": "A persistent (sticky) footer that that appears at the bottom of the card. For an example in Google Chat apps, see [Card footer](https://developers.google.com/chat/ui/widgets/card-fixed-footer). Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create).", + "description": "A persistent (sticky) footer that that appears at the bottom of the card. Setting `fixedFooter` without specifying a `primaryButton` or a `secondaryButton` causes an error. For Chat apps, you can use fixed footers in [dialogs](https://developers.google.com/chat/how-tos/dialogs), but not [card messages](https://developers.google.com/chat/api/guides/v1/messages/create#create). For an example in Google Chat apps, see [Card footer](https://developers.google.com/chat/ui/widgets/card-fixed-footer). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1CardFixedFooter", "properties": { "primaryButton": { @@ -1961,7 +1961,7 @@ "type": "object" }, "GoogleAppsCardV1CardHeader": { - "description": "Represents a card header. For an example in Google Chat apps, see [Card header](https://developers.google.com/chat/ui/widgets/card-header).", + "description": "Represents a card header. For an example in Google Chat apps, see [Card header](https://developers.google.com/chat/ui/widgets/card-header). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1CardHeader", "properties": { "imageAltText": { @@ -1969,7 +1969,7 @@ "type": "string" }, "imageType": { - "description": "The shape used to crop the image.", + "description": "The shape used to crop the image. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "enum": [ "SQUARE", "CIRCLE" @@ -1996,7 +1996,7 @@ "type": "object" }, "GoogleAppsCardV1Column": { - "description": "A column.", + "description": "A column. [Google Chat apps](https://developers.google.com/chat):", "id": "GoogleAppsCardV1Column", "properties": { "horizontalAlignment": { @@ -2016,7 +2016,7 @@ "type": "string" }, "horizontalSizeStyle": { - "description": "Specifies how a column fills the width of the card.", + "description": "Specifies how a column fills the width of the card. [Google Chat apps](https://developers.google.com/chat):", "enum": [ "HORIZONTAL_SIZE_STYLE_UNSPECIFIED", "FILL_AVAILABLE_SPACE", @@ -2030,7 +2030,7 @@ "type": "string" }, "verticalAlignment": { - "description": "Specifies whether widgets align to the top, bottom, or center of a column.", + "description": "Specifies whether widgets align to the top, bottom, or center of a column. [Google Chat apps](https://developers.google.com/chat):", "enum": [ "VERTICAL_ALIGNMENT_UNSPECIFIED", "CENTER", @@ -2056,7 +2056,7 @@ "type": "object" }, "GoogleAppsCardV1Columns": { - "description": "The `Columns` widget displays up to 2 columns in a card message or dialog. You can add widgets to each column; the widgets appear in the order that they are specified. For an example in Google Chat apps, see [Columns](https://developers.google.com/chat/ui/widgets/columns). The height of each column is determined by the taller column. For example, if the first column is taller than the second column, both columns have the height of the first column. Because each column can contain a different number of widgets, you can't define rows or align widgets between the columns. Columns are displayed side-by-side. You can customize the width of each column using the `HorizontalSizeStyle` field. If the user's screen width is too narrow, the second column wraps below the first: * On web, the second column wraps if the screen width is less than or equal to 480 pixels. * On iOS devices, the second column wraps if the screen width is less than or equal to 300 pt. * On Android devices, the second column wraps if the screen width is less than or equal to 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget. Supported by Chat apps, but not Google Workspace Add-ons.", + "description": "The `Columns` widget displays up to 2 columns in a card message or dialog. You can add widgets to each column; the widgets appear in the order that they are specified. For an example in Google Chat apps, see [Columns](https://developers.google.com/chat/ui/widgets/columns). The height of each column is determined by the taller column. For example, if the first column is taller than the second column, both columns have the height of the first column. Because each column can contain a different number of widgets, you can't define rows or align widgets between the columns. Columns are displayed side-by-side. You can customize the width of each column using the `HorizontalSizeStyle` field. If the user's screen width is too narrow, the second column wraps below the first: * On web, the second column wraps if the screen width is less than or equal to 480 pixels. * On iOS devices, the second column wraps if the screen width is less than or equal to 300 pt. * On Android devices, the second column wraps if the screen width is less than or equal to 320 dp. To include more than 2 columns, or to use rows, use the `Grid` widget. [Google Chat apps](https://developers.google.com/chat):", "id": "GoogleAppsCardV1Columns", "properties": { "columnItems": { @@ -2070,7 +2070,7 @@ "type": "object" }, "GoogleAppsCardV1DateTimePicker": { - "description": "Lets users input a date, a time, or both a date and a time. For an example in Google Chat apps, see [Date time picker](https://developers.google.com/chat/ui/widgets/date-time-picker). Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly.", + "description": "Lets users input a date, a time, or both a date and a time. For an example in Google Chat apps, see [Date time picker](https://developers.google.com/chat/ui/widgets/date-time-picker). Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1DateTimePicker", "properties": { "label": { @@ -2113,7 +2113,7 @@ "type": "object" }, "GoogleAppsCardV1DecoratedText": { - "description": "A widget that displays text with optional decorations such as a label above or below the text, an icon in front of the text, a selection widget, or a button after the text. For an example in Google Chat apps, see [Decorated text](https://developers.google.com/chat/ui/widgets/decorated-text).", + "description": "A widget that displays text with optional decorations such as a label above or below the text, an icon in front of the text, a selection widget, or a button after the text. For an example in Google Chat apps, see [Decorated text](https://developers.google.com/chat/ui/widgets/decorated-text). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1DecoratedText", "properties": { "bottomLabel": { @@ -2161,13 +2161,13 @@ "type": "object" }, "GoogleAppsCardV1Divider": { - "description": "Displays a divider between widgets as a horizontal line. For an example in Google Chat apps, see [Divider](https://developers.google.com/chat/ui/widgets/divider). For example, the following JSON creates a divider: ``` \"divider\": {} ```", + "description": "Displays a divider between widgets as a horizontal line. For an example in Google Chat apps, see [Divider](https://developers.google.com/chat/ui/widgets/divider). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a divider: ``` \"divider\": {} ```", "id": "GoogleAppsCardV1Divider", "properties": {}, "type": "object" }, "GoogleAppsCardV1Grid": { - "description": "Displays a grid with a collection of items. Items can only include text or images. For responsive columns, or to include more than text or images, use `Columns`. For an example in Google Chat apps, see [Grid](https://developers.google.com/chat/ui/widgets/grid). A grid supports any number of columns and items. The number of rows is determined by items divided by columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```", + "description": "Displays a grid with a collection of items. Items can only include text or images. For responsive columns, or to include more than text or images, use `Columns`. For an example in Google Chat apps, see [Grid](https://developers.google.com/chat/ui/widgets/grid). A grid supports any number of columns and items. The number of rows is determined by items divided by columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```", "id": "GoogleAppsCardV1Grid", "properties": { "borderStyle": { @@ -2198,7 +2198,7 @@ "type": "object" }, "GoogleAppsCardV1GridItem": { - "description": "Represents an item in a grid layout. Items can contain text, an image, or both text and an image.", + "description": "Represents an item in a grid layout. Items can contain text, an image, or both text and an image. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1GridItem", "properties": { "id": { @@ -2235,7 +2235,7 @@ "type": "object" }, "GoogleAppsCardV1Icon": { - "description": "An icon displayed in a widget on a card. For an example in Google Chat apps, see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [built-in](https://developers.google.com/chat/format-messages#builtinicons) and [custom](https://developers.google.com/chat/format-messages#customicons) icons.", + "description": "An icon displayed in a widget on a card. For an example in Google Chat apps, see [Icon](https://developers.google.com/chat/ui/widgets/icon). Supports [built-in](https://developers.google.com/chat/format-messages#builtinicons) and [custom](https://developers.google.com/chat/format-messages#customicons) icons. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Icon", "properties": { "altText": { @@ -2266,7 +2266,7 @@ "type": "object" }, "GoogleAppsCardV1Image": { - "description": "An image that is specified by a URL and can have an `onClick` action. For an example, see [Image](https://developers.google.com/chat/ui/widgets/image).", + "description": "An image that is specified by a URL and can have an `onClick` action. For an example, see [Image](https://developers.google.com/chat/ui/widgets/image). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Image", "properties": { "altText": { @@ -2285,7 +2285,7 @@ "type": "object" }, "GoogleAppsCardV1ImageComponent": { - "description": "Represents an image.", + "description": "Represents an image. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1ImageComponent", "properties": { "altText": { @@ -2308,7 +2308,7 @@ "type": "object" }, "GoogleAppsCardV1ImageCropStyle": { - "description": "Represents the crop style applied to an image. For example, here's how to apply a 16:9 aspect ratio: ``` cropStyle { \"type\": \"RECTANGLE_CUSTOM\", \"aspectRatio\": 16/9 } ```", + "description": "Represents the crop style applied to an image. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, here's how to apply a 16:9 aspect ratio: ``` cropStyle { \"type\": \"RECTANGLE_CUSTOM\", \"aspectRatio\": 16/9 } ```", "id": "GoogleAppsCardV1ImageCropStyle", "properties": { "aspectRatio": { @@ -2338,7 +2338,7 @@ "type": "object" }, "GoogleAppsCardV1OnClick": { - "description": "Represents how to respond when users click an interactive element on a card, such as a button.", + "description": "Represents how to respond when users click an interactive element on a card, such as a button. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1OnClick", "properties": { "action": { @@ -2347,11 +2347,11 @@ }, "card": { "$ref": "GoogleAppsCardV1Card", - "description": "A new card is pushed to the card stack after clicking if specified. Supported by Google Workspace Add-ons, but not Google Chat apps." + "description": "A new card is pushed to the card stack after clicking if specified. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):" }, "openDynamicLinkAction": { "$ref": "GoogleAppsCardV1Action", - "description": "An add-on triggers this action when the action needs to open a link. This differs from the `open_link` above in that this needs to talk to server to get the link. Thus some preparation work is required for web client to do before the open link action response comes back. Supported by Google Workspace Add-ons, but not Google Chat apps." + "description": "An add-on triggers this action when the action needs to open a link. This differs from the `open_link` above in that this needs to talk to server to get the link. Thus some preparation work is required for web client to do before the open link action response comes back. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):" }, "openLink": { "$ref": "GoogleAppsCardV1OpenLink", @@ -2361,11 +2361,11 @@ "type": "object" }, "GoogleAppsCardV1OpenLink": { - "description": "Represents an `onClick` event that opens a hyperlink.", + "description": "Represents an `onClick` event that opens a hyperlink. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1OpenLink", "properties": { "onClose": { - "description": "Whether the client forgets about a link after opening it, or observes it until the window closes. Not supported by Chat apps.", + "description": "Whether the client forgets about a link after opening it, or observes it until the window closes. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):", "enum": [ "NOTHING", "RELOAD" @@ -2377,7 +2377,7 @@ "type": "string" }, "openAs": { - "description": "How to open a link. Not supported by Chat apps.", + "description": "How to open a link. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):", "enum": [ "FULL_SIZE", "OVERLAY" @@ -2396,7 +2396,7 @@ "type": "object" }, "GoogleAppsCardV1PlatformDataSource": { - "description": "Chat apps only. For a `SelectionInput` widget that uses a multiselect menu, a data source from Google Workspace. Used to populate items in a multiselect menu.", + "description": "For a `SelectionInput` widget that uses a multiselect menu, a data source from Google Workspace. Used to populate items in a multiselect menu. [Google Chat apps](https://developers.google.com/chat):", "id": "GoogleAppsCardV1PlatformDataSource", "properties": { "commonDataSource": { @@ -2419,7 +2419,7 @@ "type": "object" }, "GoogleAppsCardV1Section": { - "description": "A section contains a collection of widgets that are rendered vertically in the order that they're specified.", + "description": "A section contains a collection of widgets that are rendered vertically in the order that they're specified. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Section", "properties": { "collapsible": { @@ -2446,7 +2446,7 @@ "type": "object" }, "GoogleAppsCardV1SelectionInput": { - "description": "A widget that creates one or more UI items that users can select. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see [Selection input](https://developers.google.com/chat/ui/widgets/selection-input). Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data). To collect undefined or abstract data from users, use the TextInput widget.", + "description": "A widget that creates one or more UI items that users can select. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see [Selection input](https://developers.google.com/chat/ui/widgets/selection-input). Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data). To collect undefined or abstract data from users, use the TextInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1SelectionInput", "properties": { "externalDataSource": { @@ -2500,7 +2500,7 @@ "A set of radio buttons. Users can select one radio button.", "A set of switches. Users can turn on one or more switches.", "A dropdown menu. Users can select one item from the menu.", - "Supported by Chat apps, but not Google Workspace Add-ons. A multiselect menu for static or dynamic data. From the menu bar, users select one or more items. Users can also input values to populate dynamic data. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To populate items for a multiselect menu, you can use one of the following types of data sources: * Static data: Items are specified as `SelectionItem` objects in the widget. Up to 100 items. * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus, see the [`SelectionInput` widget page](https://developers.google.com/chat/ui/widgets/selection-input#multiselect-menu)." + "A multiselect menu for static or dynamic data. From the menu bar, users select one or more items. Users can also input values to populate dynamic data. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To populate items for a multiselect menu, you can use one of the following types of data sources: * Static data: Items are specified as `SelectionItem` objects in the widget. Up to 100 items. * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus, see the [`SelectionInput` widget page](https://developers.google.com/chat/ui/widgets/selection-input#multiselect-menu). [Google Chat apps](https://developers.google.com/chat):" ], "type": "string" } @@ -2508,7 +2508,7 @@ "type": "object" }, "GoogleAppsCardV1SelectionItem": { - "description": "An item that users can select in a selection input, such as a checkbox or switch.", + "description": "An item that users can select in a selection input, such as a checkbox or switch. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1SelectionItem", "properties": { "bottomText": { @@ -2535,7 +2535,7 @@ "type": "object" }, "GoogleAppsCardV1SuggestionItem": { - "description": "One suggested value that users can enter in a text input field.", + "description": "One suggested value that users can enter in a text input field. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1SuggestionItem", "properties": { "text": { @@ -2546,7 +2546,7 @@ "type": "object" }, "GoogleAppsCardV1Suggestions": { - "description": "Suggested values that users can enter. These values appear when users click inside the text input field. As users type, the suggested values dynamically filter to match what the users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing `Jav`, the list of suggestions filters to show `Java` and `JavaScript`. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter `javascript` and others `java script`. Suggesting `JavaScript` can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`.", + "description": "Suggested values that users can enter. These values appear when users click inside the text input field. As users type, the suggested values dynamically filter to match what the users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing `Jav`, the list of suggestions filters to show `Java` and `JavaScript`. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter `javascript` and others `java script`. Suggesting `JavaScript` can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Suggestions", "properties": { "items": { @@ -2560,11 +2560,11 @@ "type": "object" }, "GoogleAppsCardV1SwitchControl": { - "description": "Either a toggle-style switch or a checkbox inside a `decoratedText` widget. Only supported in the `decoratedText` widget.", + "description": "Either a toggle-style switch or a checkbox inside a `decoratedText` widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Only supported in the `decoratedText` widget.", "id": "GoogleAppsCardV1SwitchControl", "properties": { "controlType": { - "description": "How the switch appears in the user interface.", + "description": "How the switch appears in the user interface. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "enum": [ "SWITCH", "CHECKBOX", @@ -2597,12 +2597,12 @@ "type": "object" }, "GoogleAppsCardV1TextInput": { - "description": "A field in which users can enter text. Supports suggestions and on-change actions. For an example in Google Chat apps, see [Text input](https://developers.google.com/chat/ui/widgets/text-input). Chat apps receive and can process the value of entered text during form input events. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data). When you need to collect undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget.", + "description": "A field in which users can enter text. Supports suggestions and on-change actions. For an example in Google Chat apps, see [Text input](https://developers.google.com/chat/ui/widgets/text-input). Chat apps receive and can process the value of entered text during form input events. For details about working with form inputs, see [Receive form data](https://developers.google.com/chat/ui/read-form-data). When you need to collect undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1TextInput", "properties": { "autoCompleteAction": { "$ref": "GoogleAppsCardV1Action", - "description": "Optional. Specify what action to take when the text input field provides suggestions to users who interact with it. If unspecified, the suggestions are set by `initialSuggestions` and are processed by the client. If specified, the app takes the action specified here, such as running a custom function. Supported by Google Workspace Add-ons, but not Google Chat apps." + "description": "Optional. Specify what action to take when the text input field provides suggestions to users who interact with it. If unspecified, the suggestions are set by `initialSuggestions` and are processed by the client. If specified, the app takes the action specified here, such as running a custom function. [Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):" }, "hintText": { "description": "Text that appears below the text input field meant to assist users by prompting them to enter a certain value. This text is always visible. Required if `label` is unspecified. Otherwise, optional.", @@ -2610,7 +2610,7 @@ }, "initialSuggestions": { "$ref": "GoogleAppsCardV1Suggestions", - "description": "Suggested values that users can enter. These values appear when users click inside the text input field. As users type, the suggested values dynamically filter to match what the users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing `Jav`, the list of suggestions filters to show just `Java` and `JavaScript`. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter `javascript` and others `java script`. Suggesting `JavaScript` can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`." + "description": "Suggested values that users can enter. These values appear when users click inside the text input field. As users type, the suggested values dynamically filter to match what the users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing `Jav`, the list of suggestions filters to show just `Java` and `JavaScript`. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter `javascript` and others `java script`. Suggesting `JavaScript` can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set to `MULTIPLE_LINE`. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):" }, "label": { "description": "The text that appears above the text input field in the user interface. Specify text that helps the user enter the information your app needs. For example, if you are asking someone's name, but specifically need their surname, write `surname` instead of `name`. Required if `hintText` is unspecified. Otherwise, optional.", @@ -2648,7 +2648,7 @@ "type": "object" }, "GoogleAppsCardV1TextParagraph": { - "description": "A paragraph of text that supports formatting. For an example in Google Chat apps, see [Text paragraph](https://developers.google.com/chat/ui/widgets/text-paragraph). For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).", + "description": "A paragraph of text that supports formatting. For an example in Google Chat apps, see [Text paragraph](https://developers.google.com/chat/ui/widgets/text-paragraph). For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1TextParagraph", "properties": { "text": { @@ -2684,7 +2684,7 @@ }, "grid": { "$ref": "GoogleAppsCardV1Grid", - "description": "Displays a grid with a collection of items. A grid supports any number of columns and items. The number of rows is determined by the upper bounds of the number items divided by the number of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```" + "description": "Displays a grid with a collection of items. A grid supports any number of columns and items. The number of rows is determined by the upper bounds of the number items divided by the number of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns has 6 rows. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): For example, the following JSON creates a 2 column grid with a single item: ``` \"grid\": { \"title\": \"A fine collection of items\", \"columnCount\": 2, \"borderStyle\": { \"type\": \"STROKE\", \"cornerRadius\": 4 }, \"items\": [ { \"image\": { \"imageUri\": \"https://www.example.com/image.png\", \"cropStyle\": { \"type\": \"SQUARE\" }, \"borderStyle\": { \"type\": \"STROKE\" } }, \"title\": \"An item\", \"textAlignment\": \"CENTER\" } ], \"onClick\": { \"openLink\": { \"url\": \"https://www.example.com\" } } } ```" }, "horizontalAlignment": { "description": "Specifies whether widgets align to the left, right, or center of a column.", @@ -2722,7 +2722,7 @@ "type": "object" }, "GoogleAppsCardV1Widgets": { - "description": "The supported widgets that you can include in a column.", + "description": "The supported widgets that you can include in a column. [Google Chat apps](https://developers.google.com/chat):", "id": "GoogleAppsCardV1Widgets", "properties": { "buttonList": { @@ -2768,7 +2768,7 @@ "type": "object" }, "HostAppDataSourceMarkup": { - "description": "Chat apps only. For a `SelectionInput` widget that uses a multiselect menu, a data source from a Google Workspace application. The data source populates selection items for the multiselect menu.", + "description": "For a `SelectionInput` widget that uses a multiselect menu, a data source from a Google Workspace application. The data source populates selection items for the multiselect menu. [Google Chat apps](https://developers.google.com/chat):", "id": "HostAppDataSourceMarkup", "properties": { "chatDataSource": { @@ -3218,7 +3218,7 @@ "type": "array" }, "clientAssignedMessageId": { - "description": "A custom name for a Chat message assigned at creation. Must start with `client-` and contain only lowercase letters, numbers, and hyphens up to 63 characters in length. Specify this field to get, update, or delete the message with the specified value. Assigning a custom name lets a Chat app recall the message without saving the message `name` from the [response body](/chat/api/reference/rest/v1/spaces.messages/get#response-body) returned when creating the message. Assigning a custom name doesn't replace the generated `name` field, the message's resource name. Instead, it sets the custom name as the `clientAssignedMessageId` field, which you can reference while processing later operations, like updating or deleting the message. For example usage, see [Name a created message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", + "description": "Optional. A custom ID for the message. You can use field to identify a message, or to get, delete, or update a message. To set a custom ID, specify the [`messageId`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) field when you create the message. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "type": "string" }, "createTime": { @@ -3266,7 +3266,7 @@ "readOnly": true }, "name": { - "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", "type": "string" }, "privateMessageViewer": { @@ -3586,7 +3586,7 @@ "type": "object" }, "SpaceDataSource": { - "description": "A data source that populates Google Chat spaces as selection items for a multiselect menu. Only populates spaces that the user is a member of.", + "description": "A data source that populates Google Chat spaces as selection items for a multiselect menu. Only populates spaces that the user is a member of. [Google Chat apps](https://developers.google.com/chat):", "id": "SpaceDataSource", "properties": { "defaultToCurrentSpace": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 6355dd9372f..edda4c91d63 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -913,11 +913,11 @@ func (s *ChatAppLogEntry) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ChatClientDataSourceMarkup: Chat apps only. For a `SelectionInput` -// widget that uses a multiselect menu, a data source from Google Chat. -// The data source populates selection items for the multiselect menu. -// For example, a user can select Google Chat spaces that they're a -// member of. +// ChatClientDataSourceMarkup: For a `SelectionInput` widget that uses a +// multiselect menu, a data source from Google Chat. The data source +// populates selection items for the multiselect menu. For example, a +// user can select Google Chat spaces that they're a member of. Google +// Chat apps (https://developers.google.com/chat): type ChatClientDataSourceMarkup struct { // SpaceDataSource: Google Chat spaces that the user is a member of. SpaceDataSource *SpaceDataSource `json:"spaceDataSource,omitempty"` @@ -1654,7 +1654,8 @@ func (s *FormAction) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1Action: An action that describes the behavior when // the form is submitted. For example, you can invoke an Apps Script // script to handle the form. If the action is triggered, the form -// values are sent to the server. +// values are sent to the server. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Action struct { // Function: A custom function to invoke when the containing element is // clicked or othrwise activated. For example usage, see Create @@ -1671,9 +1672,9 @@ type GoogleAppsCardV1Action struct { // respond in special interactive ways. For example, by setting // `interaction` to `OPEN_DIALOG`, the app can open a dialog // (https://developers.google.com/chat/how-tos/dialogs). When specified, - // a loading indicator isn't shown. Supported by Chat apps, but not - // Google Workspace Add-ons. If specified for an add-on, the entire card - // is stripped and nothing is shown in the client. + // a loading indicator isn't shown. If specified for an add-on, the + // entire card is stripped and nothing is shown in the client. Google + // Chat apps (https://developers.google.com/chat): // // Possible values: // "INTERACTION_UNSPECIFIED" - Default value. The `action` executes as @@ -1682,9 +1683,9 @@ type GoogleAppsCardV1Action struct { // [dialog](https://developers.google.com/chat/how-tos/dialogs), a // windowed, card-based interface that Chat apps use to interact with // users. Only supported by Chat apps in response to button-clicks on - // card messages. Not supported by Google Workspace Add-ons. If - // specified for an add-on, the entire card is stripped and nothing is - // shown in the client. + // card messages. If specified for an add-on, the entire card is + // stripped and nothing is shown in the client. [Google Chat + // apps](https://developers.google.com/chat): Interaction string `json:"interaction,omitempty"` // LoadIndicator: Specifies the loading indicator that the action @@ -1747,6 +1748,8 @@ func (s *GoogleAppsCardV1Action) MarshalJSON() ([]byte, error) { // time in the list of string parameters. To learn more, see // `CommonEventObject` // (https://developers.google.com/chat/api/reference/rest/v1/Event#commoneventobject). +// Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1ActionParameter struct { // Key: The name of the parameter for the action script. Key string `json:"key,omitempty"` @@ -1778,7 +1781,9 @@ func (s *GoogleAppsCardV1ActionParameter) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1BorderStyle: The style options for the border of a -// card or widget, including the border type and color. +// card or widget, including the border type and color. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1BorderStyle struct { // CornerRadius: The corner radius for the border. CornerRadius int64 `json:"cornerRadius,omitempty"` @@ -1821,7 +1826,9 @@ func (s *GoogleAppsCardV1BorderStyle) MarshalJSON() ([]byte, error) { // users can click. For an example in Google Chat apps, see Button list // (https://developers.google.com/chat/ui/widgets/button-list). To make // an image a clickable button, specify an `Image` (not an -// `ImageComponent`) and set an `onClick` action. +// `ImageComponent`) and set an `onClick` action. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Button struct { // AltText: The alternative text that's used for accessibility. Set // descriptive text that lets users know what the button does. For @@ -1888,7 +1895,9 @@ func (s *GoogleAppsCardV1Button) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1ButtonList: A list of buttons layed out horizontally. // For an example in Google Chat apps, see Button list -// (https://developers.google.com/chat/ui/widgets/button-list). +// (https://developers.google.com/chat/ui/widgets/button-list). Google +// Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1ButtonList struct { // Buttons: An array of buttons. Buttons []*GoogleAppsCardV1Button `json:"buttons,omitempty"` @@ -1950,19 +1959,20 @@ func (s *GoogleAppsCardV1ButtonList) MarshalJSON() ([]byte, error) { // } }, ], }, ], }, } ], } ``` type GoogleAppsCardV1Card struct { // CardActions: The card's actions. Actions are added to the card's - // toolbar menu. Because Chat app cards have no toolbar, `cardActions[]` - // isn't supported by Chat apps. For example, the following JSON - // constructs a card action menu with `Settings` and `Send Feedback` - // options: ``` "card_actions": [ { "actionLabel": "Settings", - // "onClick": { "action": { "functionName": "goToView", "parameters": [ - // { "key": "viewType", "value": "SETTING" } ], "loadIndicator": - // "LoadIndicator.SPINNER" } } }, { "actionLabel": "Send Feedback", - // "onClick": { "openLink": { "url": "https://example.com/feedback" } } - // } ] ``` + // toolbar menu. Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): For example, the + // following JSON constructs a card action menu with `Settings` and + // `Send Feedback` options: ``` "card_actions": [ { "actionLabel": + // "Settings", "onClick": { "action": { "functionName": "goToView", + // "parameters": [ { "key": "viewType", "value": "SETTING" } ], + // "loadIndicator": "LoadIndicator.SPINNER" } } }, { "actionLabel": + // "Send Feedback", "onClick": { "openLink": { "url": + // "https://example.com/feedback" } } } ] ``` CardActions []*GoogleAppsCardV1CardAction `json:"cardActions,omitempty"` - // DisplayStyle: In Google Workspace add-ons, sets the display - // properties of the `peekCardHeader`. Not supported by Chat apps. + // DisplayStyle: In Google Workspace Add-ons, sets the display + // properties of the `peekCardHeader`. Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): // // Possible values: // "DISPLAY_STYLE_UNSPECIFIED" - Don't use. Unspecified. @@ -1976,11 +1986,13 @@ type GoogleAppsCardV1Card struct { // FixedFooter: The fixed footer shown at the bottom of this card. // Setting `fixedFooter` without specifying a `primaryButton` or a - // `secondaryButton` causes an error. Supported by Google Workspace - // Add-ons and Chat apps. For Chat apps, you can use fixed footers in - // dialogs (https://developers.google.com/chat/how-tos/dialogs), but not - // card messages + // `secondaryButton` causes an error. For Chat apps, you can use fixed + // footers in dialogs + // (https://developers.google.com/chat/how-tos/dialogs), but not card + // messages // (https://developers.google.com/chat/api/guides/v1/messages/create#create). + // Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): FixedFooter *GoogleAppsCardV1CardFixedFooter `json:"fixedFooter,omitempty"` // Header: The header of the card. A header usually contains a leading @@ -1988,14 +2000,14 @@ type GoogleAppsCardV1Card struct { Header *GoogleAppsCardV1CardHeader `json:"header,omitempty"` // Name: Name of the card. Used as a card identifier in card navigation. - // Because Chat apps don't support card navigation, they ignore this - // field. + // Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): Name string `json:"name,omitempty"` // PeekCardHeader: When displaying contextual content, the peek card // header acts as a placeholder so that the user can navigate forward - // between the homepage cards and the contextual cards. Not supported by - // Chat apps. + // between the homepage cards and the contextual cards. Google Workspace + // Add-ons (https://developers.google.com/workspace/add-ons): PeekCardHeader *GoogleAppsCardV1CardHeader `json:"peekCardHeader,omitempty"` // SectionDividerStyle: The divider style between sections. @@ -2072,16 +2084,16 @@ func (s *GoogleAppsCardV1CardAction) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1CardFixedFooter: A persistent (sticky) footer that -// that appears at the bottom of the card. For an example in Google Chat -// apps, see Card footer -// (https://developers.google.com/chat/ui/widgets/card-fixed-footer). -// Setting `fixedFooter` without specifying a `primaryButton` or a -// `secondaryButton` causes an error. Google Workspace Add-ons and Chat -// apps (https://developers.google.com/workspace/extend): For Chat apps, -// you can use fixed footers in dialogs +// that appears at the bottom of the card. Setting `fixedFooter` without +// specifying a `primaryButton` or a `secondaryButton` causes an error. +// For Chat apps, you can use fixed footers in dialogs // (https://developers.google.com/chat/how-tos/dialogs), but not card // messages // (https://developers.google.com/chat/api/guides/v1/messages/create#create). +// For an example in Google Chat apps, see Card footer +// (https://developers.google.com/chat/ui/widgets/card-fixed-footer). +// Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1CardFixedFooter struct { // PrimaryButton: The primary button of the fixed footer. The button // must be a text button with text and color set. @@ -2117,13 +2129,16 @@ func (s *GoogleAppsCardV1CardFixedFooter) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1CardHeader: Represents a card header. For an example // in Google Chat apps, see Card header -// (https://developers.google.com/chat/ui/widgets/card-header). +// (https://developers.google.com/chat/ui/widgets/card-header). Google +// Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1CardHeader struct { // ImageAltText: The alternative text of this image that's used for // accessibility. ImageAltText string `json:"imageAltText,omitempty"` - // ImageType: The shape used to crop the image. + // ImageType: The shape used to crop the image. Google Workspace Add-ons + // and Chat apps (https://developers.google.com/workspace/extend): // // Possible values: // "SQUARE" - Default value. Applies a square mask to the image. For @@ -2167,7 +2182,8 @@ func (s *GoogleAppsCardV1CardHeader) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsCardV1Column: A column. +// GoogleAppsCardV1Column: A column. Google Chat apps +// (https://developers.google.com/chat): type GoogleAppsCardV1Column struct { // HorizontalAlignment: Specifies whether widgets align to the left, // right, or center of a column. @@ -2184,7 +2200,7 @@ type GoogleAppsCardV1Column struct { HorizontalAlignment string `json:"horizontalAlignment,omitempty"` // HorizontalSizeStyle: Specifies how a column fills the width of the - // card. + // card. Google Chat apps (https://developers.google.com/chat): // // Possible values: // "HORIZONTAL_SIZE_STYLE_UNSPECIFIED" - Don't use. Unspecified. @@ -2196,7 +2212,8 @@ type GoogleAppsCardV1Column struct { HorizontalSizeStyle string `json:"horizontalSizeStyle,omitempty"` // VerticalAlignment: Specifies whether widgets align to the top, - // bottom, or center of a column. + // bottom, or center of a column. Google Chat apps + // (https://developers.google.com/chat): // // Possible values: // "VERTICAL_ALIGNMENT_UNSPECIFIED" - Don't use. Unspecified. @@ -2250,8 +2267,8 @@ func (s *GoogleAppsCardV1Column) MarshalJSON() ([]byte, error) { // the second column wraps if the screen width is less than or equal to // 300 pt. * On Android devices, the second column wraps if the screen // width is less than or equal to 320 dp. To include more than 2 -// columns, or to use rows, use the `Grid` widget. Supported by Chat -// apps, but not Google Workspace Add-ons. +// columns, or to use rows, use the `Grid` widget. Google Chat apps +// (https://developers.google.com/chat): type GoogleAppsCardV1Columns struct { // ColumnItems: An array of columns. You can include up to 2 columns in // a card or dialog. @@ -2286,7 +2303,9 @@ func (s *GoogleAppsCardV1Columns) MarshalJSON() ([]byte, error) { // (https://developers.google.com/chat/ui/widgets/date-time-picker). // Users can input text or use the picker to select dates and times. If // users input an invalid date or time, the picker shows an error that -// prompts users to input the information correctly. +// prompts users to input the information correctly. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1DateTimePicker struct { // Label: The text that prompts users to input a date, a time, or a date // and time. For example, if users are scheduling an appointment, use a @@ -2356,6 +2375,8 @@ func (s *GoogleAppsCardV1DateTimePicker) MarshalJSON() ([]byte, error) { // in front of the text, a selection widget, or a button after the text. // For an example in Google Chat apps, see Decorated text // (https://developers.google.com/chat/ui/widgets/decorated-text). +// Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1DecoratedText struct { // BottomLabel: The text that appears below `text`. Always wraps. BottomLabel string `json:"bottomLabel,omitempty"` @@ -2425,8 +2446,10 @@ func (s *GoogleAppsCardV1DecoratedText) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1Divider: Displays a divider between widgets as a // horizontal line. For an example in Google Chat apps, see Divider -// (https://developers.google.com/chat/ui/widgets/divider). For example, -// the following JSON creates a divider: ``` "divider": {} ``` +// (https://developers.google.com/chat/ui/widgets/divider). Google +// Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): For example, the +// following JSON creates a divider: ``` "divider": {} ``` type GoogleAppsCardV1Divider struct { } @@ -2437,7 +2460,9 @@ type GoogleAppsCardV1Divider struct { // (https://developers.google.com/chat/ui/widgets/grid). A grid supports // any number of columns and items. The number of rows is determined by // items divided by columns. A grid with 10 items and 2 columns has 5 -// rows. A grid with 11 items and 2 columns has 6 rows. For example, the +// rows. A grid with 11 items and 2 columns has 6 rows. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): For example, the // following JSON creates a 2 column grid with a single item: ``` // "grid": { "title": "A fine collection of items", "columnCount": 2, // "borderStyle": { "type": "STROKE", "cornerRadius": 4 }, "items": [ { @@ -2490,7 +2515,9 @@ func (s *GoogleAppsCardV1Grid) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1GridItem: Represents an item in a grid layout. Items -// can contain text, an image, or both text and an image. +// can contain text, an image, or both text and an image. Google +// Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1GridItem struct { // Id: A user-specified identifier for this grid item. This identifier // is returned in the parent grid's `onClick` callback parameters. @@ -2545,7 +2572,8 @@ func (s *GoogleAppsCardV1GridItem) MarshalJSON() ([]byte, error) { // (https://developers.google.com/chat/format-messages#builtinicons) and // custom // (https://developers.google.com/chat/format-messages#customicons) -// icons. +// icons. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Icon struct { // AltText: Optional. A description of the icon used for accessibility. // If unspecified, the default value `Button` is provided. As a best @@ -2608,7 +2636,9 @@ func (s *GoogleAppsCardV1Icon) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1Image: An image that is specified by a URL and can // have an `onClick` action. For an example, see Image -// (https://developers.google.com/chat/ui/widgets/image). +// (https://developers.google.com/chat/ui/widgets/image). Google +// Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Image struct { // AltText: The alternative text of this image that's used for // accessibility. @@ -2646,7 +2676,9 @@ func (s *GoogleAppsCardV1Image) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsCardV1ImageComponent: Represents an image. +// GoogleAppsCardV1ImageComponent: Represents an image. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1ImageComponent struct { // AltText: The accessibility label for the image. AltText string `json:"altText,omitempty"` @@ -2684,8 +2716,10 @@ func (s *GoogleAppsCardV1ImageComponent) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1ImageCropStyle: Represents the crop style applied to -// an image. For example, here's how to apply a 16:9 aspect ratio: ``` -// cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 } ``` +// an image. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): For example, here's +// how to apply a 16:9 aspect ratio: ``` cropStyle { "type": +// "RECTANGLE_CUSTOM", "aspectRatio": 16/9 } ``` type GoogleAppsCardV1ImageCropStyle struct { // AspectRatio: The aspect ratio to use if the crop type is // `RECTANGLE_CUSTOM`. For example, here's how to apply a 16:9 aspect @@ -2743,22 +2777,24 @@ func (s *GoogleAppsCardV1ImageCropStyle) UnmarshalJSON(data []byte) error { } // GoogleAppsCardV1OnClick: Represents how to respond when users click -// an interactive element on a card, such as a button. +// an interactive element on a card, such as a button. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1OnClick struct { // Action: If specified, an action is triggered by this `onClick`. Action *GoogleAppsCardV1Action `json:"action,omitempty"` // Card: A new card is pushed to the card stack after clicking if - // specified. Supported by Google Workspace Add-ons, but not Google Chat - // apps. + // specified. Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): Card *GoogleAppsCardV1Card `json:"card,omitempty"` // OpenDynamicLinkAction: An add-on triggers this action when the action // needs to open a link. This differs from the `open_link` above in that // this needs to talk to server to get the link. Thus some preparation // work is required for web client to do before the open link action - // response comes back. Supported by Google Workspace Add-ons, but not - // Google Chat apps. + // response comes back. Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): OpenDynamicLinkAction *GoogleAppsCardV1Action `json:"openDynamicLinkAction,omitempty"` // OpenLink: If specified, this `onClick` triggers an open link action. @@ -2788,10 +2824,12 @@ func (s *GoogleAppsCardV1OnClick) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1OpenLink: Represents an `onClick` event that opens a -// hyperlink. +// hyperlink. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1OpenLink struct { // OnClose: Whether the client forgets about a link after opening it, or - // observes it until the window closes. Not supported by Chat apps. + // observes it until the window closes. Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): // // Possible values: // "NOTHING" - Default value. The card doesn't reload; nothing @@ -2804,7 +2842,8 @@ type GoogleAppsCardV1OpenLink struct { // closes. OnClose string `json:"onClose,omitempty"` - // OpenAs: How to open a link. Not supported by Chat apps. + // OpenAs: How to open a link. Google Workspace Add-ons + // (https://developers.google.com/workspace/add-ons): // // Possible values: // "FULL_SIZE" - The link opens as a full-size window (if that's the @@ -2838,9 +2877,10 @@ func (s *GoogleAppsCardV1OpenLink) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsCardV1PlatformDataSource: Chat apps only. For a -// `SelectionInput` widget that uses a multiselect menu, a data source -// from Google Workspace. Used to populate items in a multiselect menu. +// GoogleAppsCardV1PlatformDataSource: For a `SelectionInput` widget +// that uses a multiselect menu, a data source from Google Workspace. +// Used to populate items in a multiselect menu. Google Chat apps +// (https://developers.google.com/chat): type GoogleAppsCardV1PlatformDataSource struct { // CommonDataSource: A data source shared by all Google Workspace // applications, such as users in a Google Workspace organization. @@ -2881,6 +2921,8 @@ func (s *GoogleAppsCardV1PlatformDataSource) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1Section: A section contains a collection of widgets // that are rendered vertically in the order that they're specified. +// Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Section struct { // Collapsible: Indicates whether this section is collapsible. // Collapsible sections hide some or all widgets, but users can expand @@ -2943,6 +2985,8 @@ func (s *GoogleAppsCardV1Section) MarshalJSON() ([]byte, error) { // details about working with form inputs, see Receive form data // (https://developers.google.com/chat/ui/read-form-data). To collect // undefined or abstract data from users, use the TextInput widget. +// Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1SelectionInput struct { // ExternalDataSource: An external data source, such as a relational // data base. @@ -3000,21 +3044,21 @@ type GoogleAppsCardV1SelectionInput struct { // switches. // "DROPDOWN" - A dropdown menu. Users can select one item from the // menu. - // "MULTI_SELECT" - Supported by Chat apps, but not Google Workspace - // Add-ons. A multiselect menu for static or dynamic data. From the menu - // bar, users select one or more items. Users can also input values to - // populate dynamic data. For example, users can start typing the name - // of a Google Chat space and the widget autosuggests the space. To - // populate items for a multiselect menu, you can use one of the - // following types of data sources: * Static data: Items are specified - // as `SelectionItem` objects in the widget. Up to 100 items. * Google - // Workspace data: Items are populated using data from Google Workspace, - // such as Google Workspace users or Google Chat spaces. * External - // data: Items are populated from an external data source outside of - // Google Workspace. For examples of how to implement multiselect menus, - // see the [`SelectionInput` widget + // "MULTI_SELECT" - A multiselect menu for static or dynamic data. + // From the menu bar, users select one or more items. Users can also + // input values to populate dynamic data. For example, users can start + // typing the name of a Google Chat space and the widget autosuggests + // the space. To populate items for a multiselect menu, you can use one + // of the following types of data sources: * Static data: Items are + // specified as `SelectionItem` objects in the widget. Up to 100 items. + // * Google Workspace data: Items are populated using data from Google + // Workspace, such as Google Workspace users or Google Chat spaces. * + // External data: Items are populated from an external data source + // outside of Google Workspace. For examples of how to implement + // multiselect menus, see the [`SelectionInput` widget // page](https://developers.google.com/chat/ui/widgets/selection-input#mu - // ltiselect-menu). + // ltiselect-menu). [Google Chat + // apps](https://developers.google.com/chat): Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalDataSource") @@ -3042,7 +3086,9 @@ func (s *GoogleAppsCardV1SelectionInput) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1SelectionItem: An item that users can select in a -// selection input, such as a checkbox or switch. +// selection input, such as a checkbox or switch. Google Workspace +// Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1SelectionItem struct { // BottomText: For multiselect menus, a text description or label that's // displayed below the item's `text` field. @@ -3092,7 +3138,8 @@ func (s *GoogleAppsCardV1SelectionItem) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1SuggestionItem: One suggested value that users can -// enter in a text input field. +// enter in a text input field. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1SuggestionItem struct { // Text: The value of a suggested input to a text input field. This is // equivalent to what users enter themselves. @@ -3132,7 +3179,8 @@ func (s *GoogleAppsCardV1SuggestionItem) MarshalJSON() ([]byte, error) { // users might enter `javascript` and others `java script`. Suggesting // `JavaScript` can standardize how users interact with your app. When // specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set -// to `MULTIPLE_LINE`. +// to `MULTIPLE_LINE`. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Suggestions struct { // Items: A list of suggestions used for autocomplete recommendations in // text input fields. @@ -3162,10 +3210,13 @@ func (s *GoogleAppsCardV1Suggestions) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1SwitchControl: Either a toggle-style switch or a -// checkbox inside a `decoratedText` widget. Only supported in the -// `decoratedText` widget. +// checkbox inside a `decoratedText` widget. Google Workspace Add-ons +// and Chat apps (https://developers.google.com/workspace/extend): Only +// supported in the `decoratedText` widget. type GoogleAppsCardV1SwitchControl struct { - // ControlType: How the switch appears in the user interface. + // ControlType: How the switch appears in the user interface. Google + // Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): // // Possible values: // "SWITCH" - A toggle-style switch. @@ -3222,14 +3273,15 @@ func (s *GoogleAppsCardV1SwitchControl) MarshalJSON() ([]byte, error) { // data (https://developers.google.com/chat/ui/read-form-data). When you // need to collect undefined or abstract data from users, use a text // input. To collect defined or enumerated data from users, use the -// SelectionInput widget. +// SelectionInput widget. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1TextInput struct { // AutoCompleteAction: Optional. Specify what action to take when the // text input field provides suggestions to users who interact with it. // If unspecified, the suggestions are set by `initialSuggestions` and // are processed by the client. If specified, the app takes the action - // specified here, such as running a custom function. Supported by - // Google Workspace Add-ons, but not Google Chat apps. + // specified here, such as running a custom function. Google Workspace + // Add-ons (https://developers.google.com/workspace/add-ons): AutoCompleteAction *GoogleAppsCardV1Action `json:"autoCompleteAction,omitempty"` // HintText: Text that appears below the text input field meant to @@ -3249,7 +3301,8 @@ type GoogleAppsCardV1TextInput struct { // might enter `javascript` and others `java script`. Suggesting // `JavaScript` can standardize how users interact with your app. When // specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set - // to `MULTIPLE_LINE`. + // to `MULTIPLE_LINE`. Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): InitialSuggestions *GoogleAppsCardV1Suggestions `json:"initialSuggestions,omitempty"` // Label: The text that appears above the text input field in the user @@ -3324,6 +3377,8 @@ func (s *GoogleAppsCardV1TextInput) MarshalJSON() ([]byte, error) { // (https://developers.google.com/chat/format-messages#card-formatting) // and Formatting text in Google Workspace Add-ons // (https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). +// Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): type GoogleAppsCardV1TextParagraph struct { // Text: The text that's shown in the widget. Text string `json:"text,omitempty"` @@ -3400,14 +3455,15 @@ type GoogleAppsCardV1Widget struct { // number of columns and items. The number of rows is determined by the // upper bounds of the number items divided by the number of columns. A // grid with 10 items and 2 columns has 5 rows. A grid with 11 items and - // 2 columns has 6 rows. For example, the following JSON creates a 2 - // column grid with a single item: ``` "grid": { "title": "A fine - // collection of items", "columnCount": 2, "borderStyle": { "type": - // "STROKE", "cornerRadius": 4 }, "items": [ { "image": { "imageUri": - // "https://www.example.com/image.png", "cropStyle": { "type": "SQUARE" - // }, "borderStyle": { "type": "STROKE" } }, "title": "An item", - // "textAlignment": "CENTER" } ], "onClick": { "openLink": { "url": - // "https://www.example.com" } } } ``` + // 2 columns has 6 rows. Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): For example, the + // following JSON creates a 2 column grid with a single item: ``` + // "grid": { "title": "A fine collection of items", "columnCount": 2, + // "borderStyle": { "type": "STROKE", "cornerRadius": 4 }, "items": [ { + // "image": { "imageUri": "https://www.example.com/image.png", + // "cropStyle": { "type": "SQUARE" }, "borderStyle": { "type": "STROKE" + // } }, "title": "An item", "textAlignment": "CENTER" } ], "onClick": { + // "openLink": { "url": "https://www.example.com" } } } ``` Grid *GoogleAppsCardV1Grid `json:"grid,omitempty"` // HorizontalAlignment: Specifies whether widgets align to the left, @@ -3486,7 +3542,7 @@ func (s *GoogleAppsCardV1Widget) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1Widgets: The supported widgets that you can include -// in a column. +// in a column. Google Chat apps (https://developers.google.com/chat): type GoogleAppsCardV1Widgets struct { // ButtonList: ButtonList widget. ButtonList *GoogleAppsCardV1ButtonList `json:"buttonList,omitempty"` @@ -3562,10 +3618,10 @@ func (s *Group) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// HostAppDataSourceMarkup: Chat apps only. For a `SelectionInput` -// widget that uses a multiselect menu, a data source from a Google -// Workspace application. The data source populates selection items for -// the multiselect menu. +// HostAppDataSourceMarkup: For a `SelectionInput` widget that uses a +// multiselect menu, a data source from a Google Workspace application. +// The data source populates selection items for the multiselect menu. +// Google Chat apps (https://developers.google.com/chat): type HostAppDataSourceMarkup struct { // ChatDataSource: A data source from Google Chat. ChatDataSource *ChatClientDataSourceMarkup `json:"chatDataSource,omitempty"` @@ -4192,19 +4248,11 @@ type Message struct { // (https://addons.gsuite.google.com/uikit/builder) CardsV2 []*CardWithId `json:"cardsV2,omitempty"` - // ClientAssignedMessageId: A custom name for a Chat message assigned at - // creation. Must start with `client-` and contain only lowercase - // letters, numbers, and hyphens up to 63 characters in length. Specify - // this field to get, update, or delete the message with the specified - // value. Assigning a custom name lets a Chat app recall the message - // without saving the message `name` from the response body - // (/chat/api/reference/rest/v1/spaces.messages/get#response-body) - // returned when creating the message. Assigning a custom name doesn't - // replace the generated `name` field, the message's resource name. - // Instead, it sets the custom name as the `clientAssignedMessageId` - // field, which you can reference while processing later operations, - // like updating or deleting the message. For example usage, see Name a - // created message + // ClientAssignedMessageId: Optional. A custom ID for the message. You + // can use field to identify a message, or to get, delete, or update a + // message. To set a custom ID, specify the `messageId` + // (https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) + // field when you create the message. For details, see Name a message // (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). ClientAssignedMessageId string `json:"clientAssignedMessageId,omitempty"` @@ -4258,8 +4306,17 @@ type Message struct { // (https://developers.google.com/chat/how-tos/preview-links). MatchedUrl *MatchedUrl `json:"matchedUrl,omitempty"` - // Name: Resource name in the form `spaces/*/messages/*`. Example: - // `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB` + // Name: Resource name of the message. Format: + // `spaces/{space}/messages/{message}` Where `{space}` is the ID of the + // space where the message is posted and `{message}` is a + // system-assigned ID for the message. For example, + // `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a + // custom ID when you create a message, you can use this ID to specify + // the message in a request by replacing `{message}` with the value from + // the `clientAssignedMessageId` field. For example, + // `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see + // Name a message + // (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). Name string `json:"name,omitempty"` // PrivateMessageViewer: Immutable. Input for creating a message, @@ -4831,7 +4888,8 @@ func (s *Space) MarshalJSON() ([]byte, error) { // SpaceDataSource: A data source that populates Google Chat spaces as // selection items for a multiselect menu. Only populates spaces that -// the user is a member of. +// the user is a member of. Google Chat apps +// (https://developers.google.com/chat): type SpaceDataSource struct { // DefaultToCurrentSpace: If set to `true`, the multiselect menu selects // the current Google Chat space as an item by default. @@ -6808,7 +6866,12 @@ func (r *SpacesService) Patch(name string, space *Space) *SpacesPatchCall { // space (https://support.google.com/chat/answer/7664687) if the // organization allows users to change their history setting // (https://support.google.com/a/answer/7664184). Warning: mutually -// exclusive with all other field paths.) +// exclusive with all other field paths.) - Developer Preview: +// `access_settings.audience` (Supports changing the access setting +// (https://support.google.com/chat/answer/11971020) of a space. If no +// audience is specified in the access setting, the space's access +// setting is updated to restricted. Warning: mutually exclusive with +// all other field paths.) func (c *SpacesPatchCall) UpdateMask(updateMask string) *SpacesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -6921,7 +6984,7 @@ func (c *SpacesPatchCall) Do(opts ...googleapi.CallOption) (*Space, error) { // "type": "string" // }, // "updateMask": { - // "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.)", + // "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) - Developer Preview: `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of a space. If no audience is specified in the access setting, the space's access setting is updated to restricted. Warning: mutually exclusive with all other field paths.)", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -7878,20 +7941,16 @@ func (r *SpacesMessagesService) Create(parent string, message *Message) *SpacesM return c } -// MessageId sets the optional parameter "messageId": A custom name for -// a Chat message assigned at creation. Must start with `client-` and -// contain only lowercase letters, numbers, and hyphens up to 63 -// characters in length. Specify this field to get, update, or delete -// the message with the specified value. Assigning a custom name lets a -// a Chat app recall the message without saving the message `name` from -// the response body -// (/chat/api/reference/rest/v1/spaces.messages/get#response-body) -// returned when creating the message. Assigning a custom name doesn't -// replace the generated `name` field, the message's resource name. -// Instead, it sets the custom name as the `clientAssignedMessageId` -// field, which you can reference while processing later operations, -// like updating or deleting the message. For example usage, see Name a -// created message +// MessageId sets the optional parameter "messageId": A custom ID for a +// message. Lets Chat apps get, update, or delete a message without +// needing to store the system-assigned ID in the message's resource +// name (represented in the message `name` field). The value for this +// field must meet the following requirements: * Begins with `client-`. +// For example, `client-custom-name` is a valid custom ID, but +// `custom-name` is not. * Contains up to 63 characters and only +// lowercase letters, numbers, and hyphens. * Is unique within a space. +// A Chat app can't use the same custom ID for different messages. For +// details, see Name a message // (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). func (c *SpacesMessagesCreateCall) MessageId(messageId string) *SpacesMessagesCreateCall { c.urlParams_.Set("messageId", messageId) @@ -8043,7 +8102,7 @@ func (c *SpacesMessagesCreateCall) Do(opts ...googleapi.CallOption) (*Message, e // ], // "parameters": { // "messageId": { - // "description": "Optional. A custom name for a Chat message assigned at creation. Must start with `client-` and contain only lowercase letters, numbers, and hyphens up to 63 characters in length. Specify this field to get, update, or delete the message with the specified value. Assigning a custom name lets a a Chat app recall the message without saving the message `name` from the [response body](/chat/api/reference/rest/v1/spaces.messages/get#response-body) returned when creating the message. Assigning a custom name doesn't replace the generated `name` field, the message's resource name. Instead, it sets the custom name as the `clientAssignedMessageId` field, which you can reference while processing later operations, like updating or deleting the message. For example usage, see [Name a created message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", + // "description": "Optional. A custom ID for a message. Lets Chat apps get, update, or delete a message without needing to store the system-assigned ID in the message's resource name (represented in the message `name` field). The value for this field must meet the following requirements: * Begins with `client-`. For example, `client-custom-name` is a valid custom ID, but `custom-name` is not. * Contains up to 63 characters and only lowercase letters, numbers, and hyphens. * Is unique within a space. A Chat app can't use the same custom ID for different messages. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", // "location": "query", // "type": "string" // }, @@ -8119,9 +8178,12 @@ type SpacesMessagesDeleteCall struct { // using app authentication, requests can only delete messages created // by the calling Chat app. // -// - name: Resource name of the message that you want to delete, in the -// form `spaces/*/messages/*` Example: -// `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. +// - name: Resource name of the message. Format: +// `spaces/{space}/messages/{message}` If you've set a custom ID for +// your message, you can use the value from the +// `clientAssignedMessageId` field for `{message}`. For details, see +// [Name a message] +// (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). func (r *SpacesMessagesService) Delete(name string) *SpacesMessagesDeleteCall { c := &SpacesMessagesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8240,7 +8302,7 @@ func (c *SpacesMessagesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, err // "type": "boolean" // }, // "name": { - // "description": "Required. Resource name of the message that you want to delete, in the form `spaces/*/messages/*` Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + // "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", // "location": "path", // "pattern": "^spaces/[^/]+/messages/[^/]+$", // "required": true, @@ -8282,12 +8344,11 @@ type SpacesMessagesGetCall struct { // (https://developers.google.com/chat/api/guides/auth/users). Note: // Might return a message from a blocked member or space. // -// - name: Resource name of the message to retrieve. Format: -// `spaces/{space}/messages/{message}` If the message begins with -// `client-`, then it has a custom name assigned by a Chat app that -// created it with the Chat REST API. That Chat app (but not others) -// can pass the custom name to get, update, or delete the message. To -// learn more, see [create and name a message] +// - name: Resource name of the message. Format: +// `spaces/{space}/messages/{message}` If you've set a custom ID for +// your message, you can use the value from the +// `clientAssignedMessageId` field for `{message}`. For details, see +// [Name a message] // (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). func (r *SpacesMessagesService) Get(name string) *SpacesMessagesGetCall { c := &SpacesMessagesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -8403,7 +8464,7 @@ func (c *SpacesMessagesGetCall) Do(opts ...googleapi.CallOption) (*Message, erro // ], // "parameters": { // "name": { - // "description": "Required. Resource name of the message to retrieve. Format: `spaces/{space}/messages/{message}` If the message begins with `client-`, then it has a custom name assigned by a Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", + // "description": "Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `clientAssignedMessageId` field for `{message}`. For details, see [Name a message] (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", // "location": "path", // "pattern": "^spaces/[^/]+/messages/[^/]+$", // "required": true, @@ -8715,8 +8776,17 @@ type SpacesMessagesPatchCall struct { // using app authentication, requests can only update messages created // by the calling Chat app. // -// - name: Resource name in the form `spaces/*/messages/*`. Example: -// `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. +// - name: Resource name of the message. Format: +// `spaces/{space}/messages/{message}` Where `{space}` is the ID of +// the space where the message is posted and `{message}` is a +// system-assigned ID for the message. For example, +// `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a +// custom ID when you create a message, you can use this ID to specify +// the message in a request by replacing `{message}` with the value +// from the `clientAssignedMessageId` field. For example, +// `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see +// Name a message +// (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). func (r *SpacesMessagesService) Patch(name string, message *Message) *SpacesMessagesPatchCall { c := &SpacesMessagesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8736,11 +8806,13 @@ func (c *SpacesMessagesPatchCall) AllowMissing(allowMissing bool) *SpacesMessage } // UpdateMask sets the optional parameter "updateMask": Required. The -// field paths to update. Separate multiple values with commas. -// Currently supported field paths: - `text` - `attachment` - `cards` -// (Requires app authentication +// field paths to update. Separate multiple values with commas or use +// `*` to update all field paths. Currently supported field paths: - +// `text` - `attachment` - `cards` (Requires app authentication // (/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires app -// authentication (/chat/api/guides/auth/service-accounts).) +// authentication (/chat/api/guides/auth/service-accounts).) - Developer +// Preview: `accessory_widgets` (Requires app authentication +// (/chat/api/guides/auth/service-accounts).) func (c *SpacesMessagesPatchCall) UpdateMask(updateMask string) *SpacesMessagesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -8851,14 +8923,14 @@ func (c *SpacesMessagesPatchCall) Do(opts ...googleapi.CallOption) (*Message, er // "type": "boolean" // }, // "name": { - // "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + // "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", // "location": "path", // "pattern": "^spaces/[^/]+/messages/[^/]+$", // "required": true, // "type": "string" // }, // "updateMask": { - // "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", + // "description": "Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - Developer Preview: `accessory_widgets` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -8905,8 +8977,17 @@ type SpacesMessagesUpdateCall struct { // using app authentication, requests can only update messages created // by the calling Chat app. // -// - name: Resource name in the form `spaces/*/messages/*`. Example: -// `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. +// - name: Resource name of the message. Format: +// `spaces/{space}/messages/{message}` Where `{space}` is the ID of +// the space where the message is posted and `{message}` is a +// system-assigned ID for the message. For example, +// `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a +// custom ID when you create a message, you can use this ID to specify +// the message in a request by replacing `{message}` with the value +// from the `clientAssignedMessageId` field. For example, +// `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see +// Name a message +// (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message). func (r *SpacesMessagesService) Update(name string, message *Message) *SpacesMessagesUpdateCall { c := &SpacesMessagesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8926,11 +9007,13 @@ func (c *SpacesMessagesUpdateCall) AllowMissing(allowMissing bool) *SpacesMessag } // UpdateMask sets the optional parameter "updateMask": Required. The -// field paths to update. Separate multiple values with commas. -// Currently supported field paths: - `text` - `attachment` - `cards` -// (Requires app authentication +// field paths to update. Separate multiple values with commas or use +// `*` to update all field paths. Currently supported field paths: - +// `text` - `attachment` - `cards` (Requires app authentication // (/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires app -// authentication (/chat/api/guides/auth/service-accounts).) +// authentication (/chat/api/guides/auth/service-accounts).) - Developer +// Preview: `accessory_widgets` (Requires app authentication +// (/chat/api/guides/auth/service-accounts).) func (c *SpacesMessagesUpdateCall) UpdateMask(updateMask string) *SpacesMessagesUpdateCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -9041,14 +9124,14 @@ func (c *SpacesMessagesUpdateCall) Do(opts ...googleapi.CallOption) (*Message, e // "type": "boolean" // }, // "name": { - // "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", + // "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).", // "location": "path", // "pattern": "^spaces/[^/]+/messages/[^/]+$", // "required": true, // "type": "string" // }, // "updateMask": { - // "description": "Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", + // "description": "Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `attachment` - `cards` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2` (Requires [app authentication](/chat/api/guides/auth/service-accounts).) - Developer Preview: `accessory_widgets` (Requires [app authentication](/chat/api/guides/auth/service-accounts).)", // "format": "google-fieldmask", // "location": "query", // "type": "string" diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 98be65145ae..73c0ada77c5 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -14040,56 +14040,6 @@ "https://www.googleapis.com/auth/compute" ] }, - "export": { - "description": "Export the changed blocks between two instant snapshots to a customer's bucket in the user specified format.", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}/export", - "httpMethod": "POST", - "id": "compute.instantSnapshots.export", - "parameterOrder": [ - "project", - "zone", - "instantSnapshot" - ], - "parameters": { - "instantSnapshot": { - "description": "Name of the instant snapshot to export.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - } - }, - "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}/export", - "request": { - "$ref": "InstantSnapshotsExportRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, "get": { "description": "Returns the specified InstantSnapshot resource in the specified zone.", "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", @@ -27725,56 +27675,6 @@ "https://www.googleapis.com/auth/compute" ] }, - "export": { - "description": "Export the changed blocks between two instant snapshots to a customer's bucket in the user specified format.", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}/export", - "httpMethod": "POST", - "id": "compute.regionInstantSnapshots.export", - "parameterOrder": [ - "project", - "region", - "instantSnapshot" - ], - "parameters": { - "instantSnapshot": { - "description": "Name of the instant snapshot to export.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the zone for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}/export", - "request": { - "$ref": "RegionInstantSnapshotsExportRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, "get": { "description": "Returns the specified InstantSnapshot resource in the specified region.", "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", @@ -43688,7 +43588,7 @@ } } }, - "revision": "20231231", + "revision": "20240109", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -52918,7 +52818,7 @@ "type": "boolean" }, "allowGlobalAccess": { - "description": "This field is used along with the backend_service field for internal load balancing or with the target field for internal TargetInstance. If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created.", + "description": "If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created.", "type": "boolean" }, "allowPscGlobalAccess": { @@ -54590,7 +54490,7 @@ "id": "GuestOsFeature", "properties": { "type": { - "description": "The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE - SEV_SNP_CAPABLE - IDPF For more information, see Enabling guest operating system features.", + "description": "The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more information, see Enabling guest operating system features.", "enum": [ "BARE_METAL_LINUX_COMPATIBLE", "FEATURE_TYPE_UNSPECIFIED", @@ -62409,42 +62309,6 @@ }, "type": "object" }, - "InstantSnapshotExportParams": { - "id": "InstantSnapshotExportParams", - "properties": { - "baseInstantSnapshot": { - "description": "An optional base instant snapshot that this resource is compared against. If not specified, all blocks of this resource are exported. The base instant snapshot and this resource must be created from the same disk. The base instant snapshot must be created earlier in time than this resource.", - "type": "string" - }, - "bucketName": { - "description": "The name of an existing bucket in Cloud Storage where the changed blocks will be stored. The Google Service Account must have read and write access to this bucket. The bucket has to be in the same region as this resource.", - "type": "string" - }, - "encryptionKey": { - "$ref": "CustomerEncryptionKey", - "description": "Encryption key used to encrypt the instant snapshot." - }, - "objectName": { - "description": "Name of the output Bigstore object storing the changed blocks. Object name must be less than 1024 bytes in length.", - "type": "string" - }, - "outputType": { - "description": "The format of the output file.", - "enum": [ - "INVALID", - "METADATA_AND_DATA", - "METADATA_ONLY" - ], - "enumDescriptions": [ - "", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "InstantSnapshotList": { "description": "Contains a list of InstantSnapshot resources.", "id": "InstantSnapshotList", @@ -62608,16 +62472,6 @@ }, "type": "object" }, - "InstantSnapshotsExportRequest": { - "id": "InstantSnapshotsExportRequest", - "properties": { - "exportParams": { - "$ref": "InstantSnapshotExportParams", - "description": "Parameters to export the changed blocks." - } - }, - "type": "object" - }, "InstantSnapshotsScopedList": { "id": "InstantSnapshotsScopedList", "properties": { @@ -68328,7 +68182,7 @@ "type": "string" }, "instance": { - "description": "The name for a specific VM instance that the IP address belongs to. This is required for network endpoints of type GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group. The name must be 1-63 characters long, and comply with RFC1035.", + "description": "The name or a URL of a specific VM instance that the IP address belongs to. This is required for network endpoints of type GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", "type": "string" }, "ipAddress": { @@ -78036,16 +77890,6 @@ }, "type": "object" }, - "RegionInstantSnapshotsExportRequest": { - "id": "RegionInstantSnapshotsExportRequest", - "properties": { - "exportParams": { - "$ref": "InstantSnapshotExportParams", - "description": "Parameters to export the changed blocks." - } - }, - "type": "object" - }, "RegionList": { "description": "Contains a list of region resources.", "id": "RegionList", @@ -88735,33 +88579,38 @@ "description": "[Output Only] Type of the resource. Always compute#storagePoolType for storage pool types.", "type": "string" }, - "maxProvisionedIops": { + "maxPoolProvisionedCapacityGb": { + "description": "[Output Only] Maximum storage pool size in GB.", + "format": "int64", + "type": "string" + }, + "maxPoolProvisionedIops": { "description": "[Output Only] Maximum provisioned IOPS.", "format": "int64", "type": "string" }, - "maxProvisionedThroughput": { + "maxPoolProvisionedThroughput": { "description": "[Output Only] Maximum provisioned throughput.", "format": "int64", "type": "string" }, - "maxSizeGb": { - "description": "[Output Only] Maximum storage pool size in GB.", + "minPoolProvisionedCapacityGb": { + "description": "[Output Only] Minimum storage pool size in GB.", "format": "int64", "type": "string" }, - "minProvisionedIops": { + "minPoolProvisionedIops": { "description": "[Output Only] Minimum provisioned IOPS.", "format": "int64", "type": "string" }, - "minProvisionedThroughput": { + "minPoolProvisionedThroughput": { "description": "[Output Only] Minimum provisioned throughput.", "format": "int64", "type": "string" }, "minSizeGb": { - "description": "[Output Only] Minimum storage pool size in GB.", + "description": "[Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead.", "format": "int64", "type": "string" }, diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 73e4387968c..3f84ff56491 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -14992,15 +14992,13 @@ type ForwardingRule struct { // protocol requires allPorts be set to true. AllPorts bool `json:"allPorts,omitempty"` - // AllowGlobalAccess: This field is used along with the backend_service - // field for internal load balancing or with the target field for - // internal TargetInstance. If set to true, clients can access the - // internal passthrough Network Load Balancers, the regional internal - // Application Load Balancer, and the regional internal proxy Network - // Load Balancer from all regions. If false, only allows access from the - // local region the load balancer is located at. Note that for - // INTERNAL_MANAGED forwarding rules, this field cannot be changed after - // the forwarding rule is created. + // AllowGlobalAccess: If set to true, clients can access the internal + // passthrough Network Load Balancers, the regional internal Application + // Load Balancer, and the regional internal proxy Network Load Balancer + // from all regions. If false, only allows access from the local region + // the load balancer is located at. Note that for INTERNAL_MANAGED + // forwarding rules, this field cannot be changed after the forwarding + // rule is created. AllowGlobalAccess bool `json:"allowGlobalAccess,omitempty"` // AllowPscGlobalAccess: This is used in PSC consumer ForwardingRule to @@ -17409,8 +17407,8 @@ type GuestOsFeature struct { // commas to separate values. Set to one or more of the following // values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - // UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - - // SEV_LIVE_MIGRATABLE - SEV_SNP_CAPABLE - IDPF For more information, - // see Enabling guest operating system features. + // SEV_LIVE_MIGRATABLE - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more + // information, see Enabling guest operating system features. // // Possible values: // "BARE_METAL_LINUX_COMPATIBLE" @@ -28716,59 +28714,6 @@ func (s *InstantSnapshotAggregatedListWarningData) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -type InstantSnapshotExportParams struct { - // BaseInstantSnapshot: An optional base instant snapshot that this - // resource is compared against. If not specified, all blocks of this - // resource are exported. The base instant snapshot and this resource - // must be created from the same disk. The base instant snapshot must be - // created earlier in time than this resource. - BaseInstantSnapshot string `json:"baseInstantSnapshot,omitempty"` - - // BucketName: The name of an existing bucket in Cloud Storage where the - // changed blocks will be stored. The Google Service Account must have - // read and write access to this bucket. The bucket has to be in the - // same region as this resource. - BucketName string `json:"bucketName,omitempty"` - - // EncryptionKey: Encryption key used to encrypt the instant snapshot. - EncryptionKey *CustomerEncryptionKey `json:"encryptionKey,omitempty"` - - // ObjectName: Name of the output Bigstore object storing the changed - // blocks. Object name must be less than 1024 bytes in length. - ObjectName string `json:"objectName,omitempty"` - - // OutputType: The format of the output file. - // - // Possible values: - // "INVALID" - // "METADATA_AND_DATA" - // "METADATA_ONLY" - OutputType string `json:"outputType,omitempty"` - - // ForceSendFields is a list of field names (e.g. "BaseInstantSnapshot") - // 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. "BaseInstantSnapshot") 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 *InstantSnapshotExportParams) MarshalJSON() ([]byte, error) { - type NoMethod InstantSnapshotExportParams - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // InstantSnapshotList: Contains a list of InstantSnapshot resources. type InstantSnapshotList struct { // Id: [Output Only] Unique identifier for the resource; defined by the @@ -28990,33 +28935,6 @@ func (s *InstantSnapshotResourceStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -type InstantSnapshotsExportRequest struct { - // ExportParams: Parameters to export the changed blocks. - ExportParams *InstantSnapshotExportParams `json:"exportParams,omitempty"` - - // ForceSendFields is a list of field names (e.g. "ExportParams") 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. "ExportParams") 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 *InstantSnapshotsExportRequest) MarshalJSON() ([]byte, error) { - type NoMethod InstantSnapshotsExportRequest - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - type InstantSnapshotsScopedList struct { // InstantSnapshots: [Output Only] A list of instantSnapshots contained // in this scope. @@ -36906,11 +36824,13 @@ type NetworkEndpoint struct { // is NON_GCP_FQDN_PORT. Fqdn string `json:"fqdn,omitempty"` - // Instance: The name for a specific VM instance that the IP address - // belongs to. This is required for network endpoints of type + // Instance: The name or a URL of a specific VM instance that the IP + // address belongs to. This is required for network endpoints of type // GCE_VM_IP_PORT. The instance must be in the same zone of network - // endpoint group. The name must be 1-63 characters long, and comply - // with RFC1035. + // endpoint group (for zonal NEGs) or in the zone within the region of + // the NEG (for regional NEGs). The name must be 1-63 characters long, + // and comply with RFC1035 or be a valid URL pointing to an existing + // instance. Instance string `json:"instance,omitempty"` // IpAddress: Optional IPv4 address of network endpoint. The IP address @@ -50136,33 +50056,6 @@ func (s *RegionInstanceGroupsSetNamedPortsRequest) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -type RegionInstantSnapshotsExportRequest struct { - // ExportParams: Parameters to export the changed blocks. - ExportParams *InstantSnapshotExportParams `json:"exportParams,omitempty"` - - // ForceSendFields is a list of field names (e.g. "ExportParams") 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. "ExportParams") 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 *RegionInstantSnapshotsExportRequest) MarshalJSON() ([]byte, error) { - type NoMethod RegionInstantSnapshotsExportRequest - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // RegionList: Contains a list of region resources. type RegionList struct { // Id: [Output Only] Unique identifier for the resource; defined by the @@ -64664,24 +64557,30 @@ type StoragePoolType struct { // compute#storagePoolType for storage pool types. Kind string `json:"kind,omitempty"` - // MaxProvisionedIops: [Output Only] Maximum provisioned IOPS. - MaxProvisionedIops int64 `json:"maxProvisionedIops,omitempty,string"` + // MaxPoolProvisionedCapacityGb: [Output Only] Maximum storage pool size + // in GB. + MaxPoolProvisionedCapacityGb int64 `json:"maxPoolProvisionedCapacityGb,omitempty,string"` + + // MaxPoolProvisionedIops: [Output Only] Maximum provisioned IOPS. + MaxPoolProvisionedIops int64 `json:"maxPoolProvisionedIops,omitempty,string"` - // MaxProvisionedThroughput: [Output Only] Maximum provisioned + // MaxPoolProvisionedThroughput: [Output Only] Maximum provisioned // throughput. - MaxProvisionedThroughput int64 `json:"maxProvisionedThroughput,omitempty,string"` + MaxPoolProvisionedThroughput int64 `json:"maxPoolProvisionedThroughput,omitempty,string"` - // MaxSizeGb: [Output Only] Maximum storage pool size in GB. - MaxSizeGb int64 `json:"maxSizeGb,omitempty,string"` + // MinPoolProvisionedCapacityGb: [Output Only] Minimum storage pool size + // in GB. + MinPoolProvisionedCapacityGb int64 `json:"minPoolProvisionedCapacityGb,omitempty,string"` - // MinProvisionedIops: [Output Only] Minimum provisioned IOPS. - MinProvisionedIops int64 `json:"minProvisionedIops,omitempty,string"` + // MinPoolProvisionedIops: [Output Only] Minimum provisioned IOPS. + MinPoolProvisionedIops int64 `json:"minPoolProvisionedIops,omitempty,string"` - // MinProvisionedThroughput: [Output Only] Minimum provisioned + // MinPoolProvisionedThroughput: [Output Only] Minimum provisioned // throughput. - MinProvisionedThroughput int64 `json:"minProvisionedThroughput,omitempty,string"` + MinPoolProvisionedThroughput int64 `json:"minPoolProvisionedThroughput,omitempty,string"` - // MinSizeGb: [Output Only] Minimum storage pool size in GB. + // MinSizeGb: [Deprecated] This field is deprecated. Use + // minPoolProvisionedCapacityGb instead. MinSizeGb int64 `json:"minSizeGb,omitempty,string"` // Name: [Output Only] Name of the resource. @@ -134848,195 +134747,6 @@ func (c *InstantSnapshotsDeleteCall) Do(opts ...googleapi.CallOption) (*Operatio } -// method id "compute.instantSnapshots.export": - -type InstantSnapshotsExportCall struct { - s *Service - project string - zone string - instantSnapshot string - instantsnapshotsexportrequest *InstantSnapshotsExportRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Export: Export the changed blocks between two instant snapshots to a -// customer's bucket in the user specified format. -// -// - instantSnapshot: Name of the instant snapshot to export. -// - project: Project ID for this request. -// - zone: The name of the zone for this request. -func (r *InstantSnapshotsService) Export(project string, zone string, instantSnapshot string, instantsnapshotsexportrequest *InstantSnapshotsExportRequest) *InstantSnapshotsExportCall { - c := &InstantSnapshotsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.zone = zone - c.instantSnapshot = instantSnapshot - c.instantsnapshotsexportrequest = instantsnapshotsexportrequest - return c -} - -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. For example, consider a -// situation where you make an initial request and the request times -// out. If you make the request again with the same request ID, the -// server can check if original operation with the same request ID was -// received, and if so, will ignore the second request. This prevents -// clients from accidentally creating duplicate commitments. The request -// ID must be a valid UUID with the exception that zero UUID is not -// supported ( 00000000-0000-0000-0000-000000000000). -func (c *InstantSnapshotsExportCall) RequestId(requestId string) *InstantSnapshotsExportCall { - c.urlParams_.Set("requestId", requestId) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *InstantSnapshotsExportCall) Fields(s ...googleapi.Field) *InstantSnapshotsExportCall { - 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 *InstantSnapshotsExportCall) Context(ctx context.Context) *InstantSnapshotsExportCall { - 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 *InstantSnapshotsExportCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *InstantSnapshotsExportCall) 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.instantsnapshotsexportrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}/export") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "zone": c.zone, - "instantSnapshot": c.instantSnapshot, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.instantSnapshots.export" 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 *InstantSnapshotsExportCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Export the changed blocks between two instant snapshots to a customer's bucket in the user specified format.", - // "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}/export", - // "httpMethod": "POST", - // "id": "compute.instantSnapshots.export", - // "parameterOrder": [ - // "project", - // "zone", - // "instantSnapshot" - // ], - // "parameters": { - // "instantSnapshot": { - // "description": "Name of the instant snapshot to export.", - // "location": "path", - // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - // "required": true, - // "type": "string" - // }, - // "project": { - // "description": "Project ID for this request.", - // "location": "path", - // "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - // "required": true, - // "type": "string" - // }, - // "requestId": { - // "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - // "location": "query", - // "type": "string" - // }, - // "zone": { - // "description": "The name of the zone for this request.", - // "location": "path", - // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - // "required": true, - // "type": "string" - // } - // }, - // "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}/export", - // "request": { - // "$ref": "InstantSnapshotsExportRequest" - // }, - // "response": { - // "$ref": "Operation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/compute" - // ] - // } - -} - // method id "compute.instantSnapshots.get": type InstantSnapshotsGetCall struct { @@ -192154,195 +191864,6 @@ func (c *RegionInstantSnapshotsDeleteCall) Do(opts ...googleapi.CallOption) (*Op } -// method id "compute.regionInstantSnapshots.export": - -type RegionInstantSnapshotsExportCall struct { - s *Service - project string - region string - instantSnapshot string - regioninstantsnapshotsexportrequest *RegionInstantSnapshotsExportRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Export: Export the changed blocks between two instant snapshots to a -// customer's bucket in the user specified format. -// -// - instantSnapshot: Name of the instant snapshot to export. -// - project: Project ID for this request. -// - region: The name of the zone for this request. -func (r *RegionInstantSnapshotsService) Export(project string, region string, instantSnapshot string, regioninstantsnapshotsexportrequest *RegionInstantSnapshotsExportRequest) *RegionInstantSnapshotsExportCall { - c := &RegionInstantSnapshotsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.instantSnapshot = instantSnapshot - c.regioninstantsnapshotsexportrequest = regioninstantsnapshotsexportrequest - return c -} - -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. For example, consider a -// situation where you make an initial request and the request times -// out. If you make the request again with the same request ID, the -// server can check if original operation with the same request ID was -// received, and if so, will ignore the second request. This prevents -// clients from accidentally creating duplicate commitments. The request -// ID must be a valid UUID with the exception that zero UUID is not -// supported ( 00000000-0000-0000-0000-000000000000). -func (c *RegionInstantSnapshotsExportCall) RequestId(requestId string) *RegionInstantSnapshotsExportCall { - c.urlParams_.Set("requestId", requestId) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *RegionInstantSnapshotsExportCall) Fields(s ...googleapi.Field) *RegionInstantSnapshotsExportCall { - 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 *RegionInstantSnapshotsExportCall) Context(ctx context.Context) *RegionInstantSnapshotsExportCall { - 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 *RegionInstantSnapshotsExportCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionInstantSnapshotsExportCall) 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.regioninstantsnapshotsexportrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}/export") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "instantSnapshot": c.instantSnapshot, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionInstantSnapshots.export" 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 *RegionInstantSnapshotsExportCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Export the changed blocks between two instant snapshots to a customer's bucket in the user specified format.", - // "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}/export", - // "httpMethod": "POST", - // "id": "compute.regionInstantSnapshots.export", - // "parameterOrder": [ - // "project", - // "region", - // "instantSnapshot" - // ], - // "parameters": { - // "instantSnapshot": { - // "description": "Name of the instant snapshot to export.", - // "location": "path", - // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - // "required": true, - // "type": "string" - // }, - // "project": { - // "description": "Project ID for this request.", - // "location": "path", - // "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - // "required": true, - // "type": "string" - // }, - // "region": { - // "description": "The name of the zone for this request.", - // "location": "path", - // "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - // "required": true, - // "type": "string" - // }, - // "requestId": { - // "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - // "location": "query", - // "type": "string" - // } - // }, - // "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}/export", - // "request": { - // "$ref": "RegionInstantSnapshotsExportRequest" - // }, - // "response": { - // "$ref": "Operation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/compute" - // ] - // } - -} - // method id "compute.regionInstantSnapshots.get": type RegionInstantSnapshotsGetCall struct { diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 0cb0681c09f..5c9c6c9f87d 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -4596,7 +4596,7 @@ } } }, - "revision": "20240108", + "revision": "20240111", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -6274,7 +6274,8 @@ "NUMBER", "INTEGER", "BOOLEAN", - "GEOLOCATION" + "GEOLOCATION", + "DATETIME" ], "enumDescriptions": [ "Field type is unspecified.", @@ -6283,7 +6284,8 @@ "Field value type is Number.", "Field value type is Integer.", "Field value type is Boolean.", - "Field value type is Geolocation." + "Field value type is Geolocation.", + "Field value type is Datetime." ], "readOnly": true, "type": "string" diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index e611cfcdf3b..0b2d2a70d1f 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -3773,6 +3773,7 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // "INTEGER" - Field value type is Integer. // "BOOLEAN" - Field value type is Boolean. // "GEOLOCATION" - Field value type is Geolocation. + // "DATETIME" - Field value type is Datetime. FieldType string `json:"fieldType,omitempty"` // IndexableOption: If indexable_option is INDEXABLE_ENABLED, field diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index 71cfe62f1ba..94bf0b75c5b 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -3042,7 +3042,7 @@ } } }, - "revision": "20240108", + "revision": "20240111", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4172,7 +4172,8 @@ "NUMBER", "INTEGER", "BOOLEAN", - "GEOLOCATION" + "GEOLOCATION", + "DATETIME" ], "enumDescriptions": [ "Field type is unspecified.", @@ -4181,7 +4182,8 @@ "Field value type is Number.", "Field value type is Integer.", "Field value type is Boolean.", - "Field value type is Geolocation." + "Field value type is Geolocation.", + "Field value type is Datetime." ], "readOnly": true, "type": "string" diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 7448cf2d8d3..77860246b56 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -2661,6 +2661,7 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // "INTEGER" - Field value type is Integer. // "BOOLEAN" - Field value type is Boolean. // "GEOLOCATION" - Field value type is Geolocation. + // "DATETIME" - Field value type is Datetime. FieldType string `json:"fieldType,omitempty"` // IndexableOption: If indexable_option is INDEXABLE_ENABLED, field diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index aa25f84046a..4fc039e616f 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1042,7 +1042,7 @@ } } }, - "revision": "20231116", + "revision": "20240112", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -2055,6 +2055,13 @@ "$ref": "GoogleCloudDocumentaiV1BatchDocumentsInputConfig", "description": "The input documents for the BatchProcessDocuments method." }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels with user-defined metadata for the request. Label keys and values can be no longer than 63 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", + "type": "object" + }, "processOptions": { "$ref": "GoogleCloudDocumentaiV1ProcessOptions", "description": "Inference-time options for the process API" @@ -4108,7 +4115,7 @@ }, "ocrConfig": { "$ref": "GoogleCloudDocumentaiV1OcrConfig", - "description": "Only applicable to `OCR_PROCESSOR`. Returns error if set on other processor types." + "description": "Only applicable to `OCR_PROCESSOR` and `FORM_PARSER_PROCESSOR`. Returns error if set on other processor types." } }, "type": "object" @@ -4145,6 +4152,13 @@ "$ref": "GoogleCloudDocumentaiV1Document", "description": "An inline document proto." }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels with user-defined metadata for the request. Label keys and values can be no longer than 63 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", + "type": "object" + }, "processOptions": { "$ref": "GoogleCloudDocumentaiV1ProcessOptions", "description": "Inference-time options for the process API" @@ -7671,7 +7685,7 @@ "documentWarehouseConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig", "deprecated": true, - "description": "Optional. Derepcated. Warehouse-based dataset configuration is not supported today." + "description": "Optional. Deprecated. Warehouse-based dataset configuration is not supported." }, "gcsManagedConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig", diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index 9f07baa3690..4a7668d92ba 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -2125,6 +2125,14 @@ type GoogleCloudDocumentaiV1BatchProcessRequest struct { // method. InputDocuments *GoogleCloudDocumentaiV1BatchDocumentsInputConfig `json:"inputDocuments,omitempty"` + // Labels: Optional. The labels with user-defined metadata for the + // request. Label keys and values can be no longer than 63 characters + // (Unicode codepoints), can only contain lowercase letters, numeric + // characters, underscores and dashes. International characters are + // allowed. Label values are optional. Label keys must start with a + // letter. + Labels map[string]string `json:"labels,omitempty"` + // ProcessOptions: Inference-time options for the process API ProcessOptions *GoogleCloudDocumentaiV1ProcessOptions `json:"processOptions,omitempty"` @@ -5512,8 +5520,9 @@ type GoogleCloudDocumentaiV1ProcessOptions struct { // IndividualPageSelector: Which pages to process (1-indexed). IndividualPageSelector *GoogleCloudDocumentaiV1ProcessOptionsIndividualPageSelector `json:"individualPageSelector,omitempty"` - // OcrConfig: Only applicable to `OCR_PROCESSOR`. Returns error if set - // on other processor types. + // OcrConfig: Only applicable to `OCR_PROCESSOR` and + // `FORM_PARSER_PROCESSOR`. Returns error if set on other processor + // types. OcrConfig *GoogleCloudDocumentaiV1OcrConfig `json:"ocrConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "FromEnd") to @@ -5583,6 +5592,14 @@ type GoogleCloudDocumentaiV1ProcessRequest struct { // InlineDocument: An inline document proto. InlineDocument *GoogleCloudDocumentaiV1Document `json:"inlineDocument,omitempty"` + // Labels: Optional. The labels with user-defined metadata for the + // request. Label keys and values can be no longer than 63 characters + // (Unicode codepoints), can only contain lowercase letters, numeric + // characters, underscores and dashes. International characters are + // allowed. Label values are optional. Label keys must start with a + // letter. + Labels map[string]string `json:"labels,omitempty"` + // ProcessOptions: Inference-time options for the process API ProcessOptions *GoogleCloudDocumentaiV1ProcessOptions `json:"processOptions,omitempty"` @@ -11281,8 +11298,8 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b // GoogleCloudDocumentaiV1beta3Dataset: A singleton resource under a // Processor which configures a collection of documents. type GoogleCloudDocumentaiV1beta3Dataset struct { - // DocumentWarehouseConfig: Optional. Derepcated. Warehouse-based - // dataset configuration is not supported today. + // DocumentWarehouseConfig: Optional. Deprecated. Warehouse-based + // dataset configuration is not supported. DocumentWarehouseConfig *GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig `json:"documentWarehouseConfig,omitempty"` // GcsManagedConfig: Optional. User-managed Cloud Storage dataset diff --git a/documentai/v1beta2/documentai-api.json b/documentai/v1beta2/documentai-api.json index 35f518ff990..13bf02ca39c 100644 --- a/documentai/v1beta2/documentai-api.json +++ b/documentai/v1beta2/documentai-api.json @@ -292,7 +292,7 @@ } } }, - "revision": "20231116", + "revision": "20240112", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -4723,7 +4723,7 @@ "documentWarehouseConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig", "deprecated": true, - "description": "Optional. Derepcated. Warehouse-based dataset configuration is not supported today." + "description": "Optional. Deprecated. Warehouse-based dataset configuration is not supported." }, "gcsManagedConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig", diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index e0c93c29e95..857a4e738d2 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -7663,8 +7663,8 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b // GoogleCloudDocumentaiV1beta3Dataset: A singleton resource under a // Processor which configures a collection of documents. type GoogleCloudDocumentaiV1beta3Dataset struct { - // DocumentWarehouseConfig: Optional. Derepcated. Warehouse-based - // dataset configuration is not supported today. + // DocumentWarehouseConfig: Optional. Deprecated. Warehouse-based + // dataset configuration is not supported. DocumentWarehouseConfig *GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig `json:"documentWarehouseConfig,omitempty"` // GcsManagedConfig: Optional. User-managed Cloud Storage dataset diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 03a82076e6a..5107e05d4cd 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1284,7 +1284,7 @@ } } }, - "revision": "20231130", + "revision": "20240112", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -5568,6 +5568,13 @@ "$ref": "GoogleCloudDocumentaiV1beta3BatchDocumentsInputConfig", "description": "The input documents for the BatchProcessDocuments method." }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels with user-defined metadata for the request. Label keys and values can be no longer than 63 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", + "type": "object" + }, "outputConfig": { "$ref": "GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig", "deprecated": true, @@ -5691,7 +5698,7 @@ "documentWarehouseConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig", "deprecated": true, - "description": "Optional. Derepcated. Warehouse-based dataset configuration is not supported today." + "description": "Optional. Deprecated. Warehouse-based dataset configuration is not supported." }, "gcsManagedConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DatasetGCSManagedConfig", @@ -8118,7 +8125,7 @@ }, "ocrConfig": { "$ref": "GoogleCloudDocumentaiV1beta3OcrConfig", - "description": "Only applicable to `OCR_PROCESSOR`. Returns error if set on other processor types." + "description": "Only applicable to `OCR_PROCESSOR` and `FORM_PARSER_PROCESSOR`. Returns error if set on other processor types." }, "schemaOverride": { "$ref": "GoogleCloudDocumentaiV1beta3DocumentSchema", @@ -8164,6 +8171,13 @@ "$ref": "GoogleCloudDocumentaiV1beta3Document", "description": "An inline document proto." }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels with user-defined metadata for the request. Label keys and values can be no longer than 63 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", + "type": "object" + }, "processOptions": { "$ref": "GoogleCloudDocumentaiV1beta3ProcessOptions", "description": "Inference-time options for the process API" @@ -8796,12 +8810,12 @@ "id": "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestFoundationModelTuningOptions", "properties": { "learningRateMultiplier": { - "description": "Optional. The multiplier to apply to the recommended learning rate. Valid values are between [0.1, 10]. If not provided, recommended learning rate will be used.", + "description": "Optional. The multiplier to apply to the recommended learning rate. Valid values are between 0.1 and 10. If not provided, recommended learning rate will be used.", "format": "float", "type": "number" }, "trainSteps": { - "description": "Optional. The number of steps to run for model tuning. Valid values are between [1, 400]. If not provided, recommended steps will be used.", + "description": "Optional. The number of steps to run for model tuning. Valid values are between 1 and 400. If not provided, recommended steps will be used.", "format": "int32", "type": "integer" } diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 1f109307f7d..0b96d884701 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -7483,6 +7483,14 @@ type GoogleCloudDocumentaiV1beta3BatchProcessRequest struct { // method. InputDocuments *GoogleCloudDocumentaiV1beta3BatchDocumentsInputConfig `json:"inputDocuments,omitempty"` + // Labels: Optional. The labels with user-defined metadata for the + // request. Label keys and values can be no longer than 63 characters + // (Unicode codepoints), can only contain lowercase letters, numeric + // characters, underscores and dashes. International characters are + // allowed. Label values are optional. Label keys must start with a + // letter. + Labels map[string]string `json:"labels,omitempty"` + // OutputConfig: The overall output config for batch process. OutputConfig *GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig `json:"outputConfig,omitempty"` @@ -7677,8 +7685,8 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b // GoogleCloudDocumentaiV1beta3Dataset: A singleton resource under a // Processor which configures a collection of documents. type GoogleCloudDocumentaiV1beta3Dataset struct { - // DocumentWarehouseConfig: Optional. Derepcated. Warehouse-based - // dataset configuration is not supported today. + // DocumentWarehouseConfig: Optional. Deprecated. Warehouse-based + // dataset configuration is not supported. DocumentWarehouseConfig *GoogleCloudDocumentaiV1beta3DatasetDocumentWarehouseConfig `json:"documentWarehouseConfig,omitempty"` // GcsManagedConfig: Optional. User-managed Cloud Storage dataset @@ -11859,8 +11867,9 @@ type GoogleCloudDocumentaiV1beta3ProcessOptions struct { // IndividualPageSelector: Which pages to process (1-indexed). IndividualPageSelector *GoogleCloudDocumentaiV1beta3ProcessOptionsIndividualPageSelector `json:"individualPageSelector,omitempty"` - // OcrConfig: Only applicable to `OCR_PROCESSOR`. Returns error if set - // on other processor types. + // OcrConfig: Only applicable to `OCR_PROCESSOR` and + // `FORM_PARSER_PROCESSOR`. Returns error if set on other processor + // types. OcrConfig *GoogleCloudDocumentaiV1beta3OcrConfig `json:"ocrConfig,omitempty"` // SchemaOverride: Optional. Override the schema of the @@ -11940,6 +11949,14 @@ type GoogleCloudDocumentaiV1beta3ProcessRequest struct { // InlineDocument: An inline document proto. InlineDocument *GoogleCloudDocumentaiV1beta3Document `json:"inlineDocument,omitempty"` + // Labels: Optional. The labels with user-defined metadata for the + // request. Label keys and values can be no longer than 63 characters + // (Unicode codepoints), can only contain lowercase letters, numeric + // characters, underscores and dashes. International characters are + // allowed. Label values are optional. Label keys must start with a + // letter. + Labels map[string]string `json:"labels,omitempty"` + // ProcessOptions: Inference-time options for the process API ProcessOptions *GoogleCloudDocumentaiV1beta3ProcessOptions `json:"processOptions,omitempty"` @@ -12934,13 +12951,13 @@ func (s *GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestCustomDocumentE // processor. type GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestFoundationModelTuningOptions struct { // LearningRateMultiplier: Optional. The multiplier to apply to the - // recommended learning rate. Valid values are between [0.1, 10]. If not - // provided, recommended learning rate will be used. + // recommended learning rate. Valid values are between 0.1 and 10. If + // not provided, recommended learning rate will be used. LearningRateMultiplier float64 `json:"learningRateMultiplier,omitempty"` // TrainSteps: Optional. The number of steps to run for model tuning. - // Valid values are between [1, 400]. If not provided, recommended steps - // will be used. + // Valid values are between 1 and 400. If not provided, recommended + // steps will be used. TrainSteps int64 `json:"trainSteps,omitempty"` // ForceSendFields is a list of field names (e.g. diff --git a/monitoring/v1/monitoring-api.json b/monitoring/v1/monitoring-api.json index 11fd7e297a3..88d247292f3 100644 --- a/monitoring/v1/monitoring-api.json +++ b/monitoring/v1/monitoring-api.json @@ -753,7 +753,7 @@ } } }, - "revision": "20240109", + "revision": "20240115", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -1195,19 +1195,19 @@ "type": "object" }, "Dimension": { - "description": "A chart dimension. Dimensions are a structured labewl, class, or category for a set of measurements in your data.", + "description": "Preview: A chart dimension for an SQL query. This is applied over the x-axis. This is a preview feature and may be subject to change before final release.", "id": "Dimension", "properties": { "column": { - "description": "The name of the column in the source SQL query that is used to chart the dimension.", + "description": "Required. The name of the column in the source SQL query that is used to chart the dimension.", "type": "string" }, "columnType": { - "description": "The type of the dimension column. This is relevant only if one of the bin_size fields is set. If it is empty, the type TIMESTAMP or INT64 will be assumed based on which bin_size field is set. If populated, this should be set to one of the following types: DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, NUMERIC, FLOAT64.", + "description": "Optional. The type of the dimension column. This is relevant only if one of the bin_size fields is set. If it is empty, the type TIMESTAMP or INT64 will be assumed based on which bin_size field is set. If populated, this should be set to one of the following types: DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, NUMERIC, FLOAT64.", "type": "string" }, "floatBinSize": { - "description": "float_bin_size is used when the column type used for a dimension is a floating point numeric column.", + "description": "Optional. float_bin_size is used when the column type used for a dimension is a floating point numeric column.", "format": "double", "type": "number" }, @@ -1242,7 +1242,7 @@ "type": "string" }, "timeBinSize": { - "description": "time_bin_size is used when the data type specified by column is a time type and the bin size is determined by a time duration.", + "description": "time_bin_size is used when the data type specified by column is a time type and the bin size is determined by a time duration. If column_type is DATE, this must be a whole value multiple of 1 day. If column_type is TIME, this must be less than or equal to 24 hours.", "format": "google-duration", "type": "string" } @@ -1555,15 +1555,15 @@ "type": "object" }, "Measure": { - "description": "A chart measure. Measures represent a measured property in your chart data such as rainfall in inches, number of units sold, revenue gained, etc.", + "description": "Preview: A chart measure for an SQL query. This is applied over the y-axis. This is a preview feature and may be subject to change before final release.", "id": "Measure", "properties": { "aggregationFunction": { "$ref": "AggregationFunction", - "description": "The aggregation function applied to the input column. This must not be set to \"none\" unless binning is disabled on the dimension. The aggregation function is used to group points on the dimension bins." + "description": "Required. The aggregation function applied to the input column. This must not be set to \"none\" unless binning is disabled on the dimension. The aggregation function is used to group points on the dimension bins." }, "column": { - "description": "The column name within the dataset used for the measure.", + "description": "Required. The column name within in the dataset used for the measure.", "type": "string" } }, @@ -1857,20 +1857,6 @@ "description": "Groups a time series query definition.", "id": "PieChartDataSet", "properties": { - "dimensions": { - "description": "A dimension is a structured label, class, or category for a set of measurements in your data.", - "items": { - "$ref": "Dimension" - }, - "type": "array" - }, - "measures": { - "description": "A measure is a measured value of a property in your data. For example, rainfall in inches, number of units sold, revenue gained, etc.", - "items": { - "$ref": "Measure" - }, - "type": "array" - }, "minAlignmentPeriod": { "description": "Optional. The lower bound on data point frequency for this data set, implemented by specifying the minimum alignment period to use in a time series query. For example, if the data is published once every 10 minutes, the min_alignment_period should be at least 10 minutes. It would not make sense to fetch and align data at one minute intervals.", "format": "google-duration", diff --git a/monitoring/v1/monitoring-gen.go b/monitoring/v1/monitoring-gen.go index 4876ec7757e..046450aeb8e 100644 --- a/monitoring/v1/monitoring-gen.go +++ b/monitoring/v1/monitoring-gen.go @@ -1130,22 +1130,24 @@ func (s *DataSet) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Dimension: A chart dimension. Dimensions are a structured labewl, -// class, or category for a set of measurements in your data. +// Dimension: Preview: A chart dimension for an SQL query. This is +// applied over the x-axis. This is a preview feature and may be subject +// to change before final release. type Dimension struct { - // Column: The name of the column in the source SQL query that is used - // to chart the dimension. + // Column: Required. The name of the column in the source SQL query that + // is used to chart the dimension. Column string `json:"column,omitempty"` - // ColumnType: The type of the dimension column. This is relevant only - // if one of the bin_size fields is set. If it is empty, the type - // TIMESTAMP or INT64 will be assumed based on which bin_size field is - // set. If populated, this should be set to one of the following types: - // DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, NUMERIC, FLOAT64. + // ColumnType: Optional. The type of the dimension column. This is + // relevant only if one of the bin_size fields is set. If it is empty, + // the type TIMESTAMP or INT64 will be assumed based on which bin_size + // field is set. If populated, this should be set to one of the + // following types: DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, + // NUMERIC, FLOAT64. ColumnType string `json:"columnType,omitempty"` - // FloatBinSize: float_bin_size is used when the column type used for a - // dimension is a floating point numeric column. + // FloatBinSize: Optional. float_bin_size is used when the column type + // used for a dimension is a floating point numeric column. FloatBinSize float64 `json:"floatBinSize,omitempty"` // MaxBinCount: A limit to the number of bins generated. When 0 is @@ -1176,7 +1178,9 @@ type Dimension struct { // TimeBinSize: time_bin_size is used when the data type specified by // column is a time type and the bin size is determined by a time - // duration. + // duration. If column_type is DATE, this must be a whole value multiple + // of 1 day. If column_type is TIME, this must be less than or equal to + // 24 hours. TimeBinSize string `json:"timeBinSize,omitempty"` // ForceSendFields is a list of field names (e.g. "Column") to @@ -1733,17 +1737,18 @@ func (s *LogsPanel) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Measure: A chart measure. Measures represent a measured property in -// your chart data such as rainfall in inches, number of units sold, -// revenue gained, etc. +// Measure: Preview: A chart measure for an SQL query. This is applied +// over the y-axis. This is a preview feature and may be subject to +// change before final release. type Measure struct { - // AggregationFunction: The aggregation function applied to the input - // column. This must not be set to "none" unless binning is disabled on - // the dimension. The aggregation function is used to group points on - // the dimension bins. + // AggregationFunction: Required. The aggregation function applied to + // the input column. This must not be set to "none" unless binning is + // disabled on the dimension. The aggregation function is used to group + // points on the dimension bins. AggregationFunction *AggregationFunction `json:"aggregationFunction,omitempty"` - // Column: The column name within the dataset used for the measure. + // Column: Required. The column name within in the dataset used for the + // measure. Column string `json:"column,omitempty"` // ForceSendFields is a list of field names (e.g. "AggregationFunction") @@ -2273,15 +2278,6 @@ func (s *PieChart) MarshalJSON() ([]byte, error) { // PieChartDataSet: Groups a time series query definition. type PieChartDataSet struct { - // Dimensions: A dimension is a structured label, class, or category for - // a set of measurements in your data. - Dimensions []*Dimension `json:"dimensions,omitempty"` - - // Measures: A measure is a measured value of a property in your data. - // For example, rainfall in inches, number of units sold, revenue - // gained, etc. - Measures []*Measure `json:"measures,omitempty"` - // MinAlignmentPeriod: Optional. The lower bound on data point frequency // for this data set, implemented by specifying the minimum alignment // period to use in a time series query. For example, if the data is @@ -2301,20 +2297,21 @@ type PieChartDataSet struct { // google.monitoring.dashboard.v1.TimeSeriesQuery. TimeSeriesQuery *TimeSeriesQuery `json:"timeSeriesQuery,omitempty"` - // ForceSendFields is a list of field names (e.g. "Dimensions") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "MinAlignmentPeriod") + // 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. "Dimensions") 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. "MinAlignmentPeriod") 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/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json index f059ed0ed61..2c3493842b9 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json @@ -180,8 +180,24 @@ "https://www.googleapis.com/auth/sasportal" ] }, + "listGcpProjectDeployments": { + "description": "Returns a list of SAS deployments associated with current GCP project. Includes whether SAS analytics has been enabled or not.", + "flatPath": "v1alpha1/customers:listGcpProjectDeployments", + "httpMethod": "GET", + "id": "prod_tt_sasportal.customers.listGcpProjectDeployments", + "parameterOrder": [], + "parameters": {}, + "path": "v1alpha1/customers:listGcpProjectDeployments", + "response": { + "$ref": "SasPortalListGcpProjectDeploymentsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sasportal" + ] + }, "listLegacyOrganizations": { - "description": "Checks whether account is legacy.", + "description": "Returns a list of legacy organizations.", "flatPath": "v1alpha1/customers:listLegacyOrganizations", "httpMethod": "GET", "id": "prod_tt_sasportal.customers.listLegacyOrganizations", @@ -2653,7 +2669,7 @@ } } }, - "revision": "20240110", + "revision": "20240115", "rootUrl": "https://prod-tt-sasportal.googleapis.com/", "schemas": { "SasPortalAssignment": { @@ -3149,6 +3165,21 @@ }, "type": "object" }, + "SasPortalGcpProjectDeployment": { + "description": "Deployment associated with the GCP project. Includes whether SAS analytics has been enabled or not.", + "id": "SasPortalGcpProjectDeployment", + "properties": { + "deployment": { + "$ref": "SasPortalDeployment", + "description": "Deployment associated with the GCP project." + }, + "hasEnabledAnalytics": { + "description": "Whether SAS analytics has been enabled.", + "type": "boolean" + } + }, + "type": "object" + }, "SasPortalGenerateSecretRequest": { "description": "Request for GenerateSecret.", "id": "SasPortalGenerateSecretRequest", @@ -3314,6 +3345,20 @@ }, "type": "object" }, + "SasPortalListGcpProjectDeploymentsResponse": { + "description": "Response for [ListGcpProjectDeployments].", + "id": "SasPortalListGcpProjectDeploymentsResponse", + "properties": { + "deployments": { + "description": "Optional. Deployments associated with the GCP project", + "items": { + "$ref": "SasPortalGcpProjectDeployment" + }, + "type": "array" + } + }, + "type": "object" + }, "SasPortalListLegacyOrganizationsResponse": { "description": "Response for [ListLegacyOrganizations]. [spectrum.sas.portal.v1alpha1.Provisioning.ListLegacyOrganizations].", "id": "SasPortalListLegacyOrganizationsResponse", diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go index fc9f50400c6..e35fa4e2f66 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go @@ -1133,6 +1133,38 @@ func (s *SasPortalFrequencyRange) UnmarshalJSON(data []byte) error { return nil } +// SasPortalGcpProjectDeployment: Deployment associated with the GCP +// project. Includes whether SAS analytics has been enabled or not. +type SasPortalGcpProjectDeployment struct { + // Deployment: Deployment associated with the GCP project. + Deployment *SasPortalDeployment `json:"deployment,omitempty"` + + // HasEnabledAnalytics: Whether SAS analytics has been enabled. + HasEnabledAnalytics bool `json:"hasEnabledAnalytics,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Deployment") 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. "Deployment") 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 *SasPortalGcpProjectDeployment) MarshalJSON() ([]byte, error) { + type NoMethod SasPortalGcpProjectDeployment + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SasPortalGenerateSecretRequest: Request for GenerateSecret. type SasPortalGenerateSecretRequest struct { } @@ -1443,6 +1475,39 @@ func (s *SasPortalListDevicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SasPortalListGcpProjectDeploymentsResponse: Response for +// [ListGcpProjectDeployments]. +type SasPortalListGcpProjectDeploymentsResponse struct { + // Deployments: Optional. Deployments associated with the GCP project + Deployments []*SasPortalGcpProjectDeployment `json:"deployments,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Deployments") 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. "Deployments") 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 *SasPortalListGcpProjectDeploymentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod SasPortalListGcpProjectDeploymentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SasPortalListLegacyOrganizationsResponse: Response for // [ListLegacyOrganizations]. // [spectrum.sas.portal.v1alpha1.Provisioning.ListLegacyOrganizations]. @@ -2774,6 +2839,140 @@ func (c *CustomersListCall) Pages(ctx context.Context, f func(*SasPortalListCust } } +// method id "prod_tt_sasportal.customers.listGcpProjectDeployments": + +type CustomersListGcpProjectDeploymentsCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListGcpProjectDeployments: Returns a list of SAS deployments +// associated with current GCP project. Includes whether SAS analytics +// has been enabled or not. +func (r *CustomersService) ListGcpProjectDeployments() *CustomersListGcpProjectDeploymentsCall { + c := &CustomersListGcpProjectDeploymentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + 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 *CustomersListGcpProjectDeploymentsCall) Fields(s ...googleapi.Field) *CustomersListGcpProjectDeploymentsCall { + 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 *CustomersListGcpProjectDeploymentsCall) IfNoneMatch(entityTag string) *CustomersListGcpProjectDeploymentsCall { + 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 *CustomersListGcpProjectDeploymentsCall) Context(ctx context.Context) *CustomersListGcpProjectDeploymentsCall { + 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 *CustomersListGcpProjectDeploymentsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *CustomersListGcpProjectDeploymentsCall) 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, "v1alpha1/customers:listGcpProjectDeployments") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "prod_tt_sasportal.customers.listGcpProjectDeployments" call. +// Exactly one of *SasPortalListGcpProjectDeploymentsResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *SasPortalListGcpProjectDeploymentsResponse.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 *CustomersListGcpProjectDeploymentsCall) Do(opts ...googleapi.CallOption) (*SasPortalListGcpProjectDeploymentsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SasPortalListGcpProjectDeploymentsResponse{ + 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": "Returns a list of SAS deployments associated with current GCP project. Includes whether SAS analytics has been enabled or not.", + // "flatPath": "v1alpha1/customers:listGcpProjectDeployments", + // "httpMethod": "GET", + // "id": "prod_tt_sasportal.customers.listGcpProjectDeployments", + // "parameterOrder": [], + // "parameters": {}, + // "path": "v1alpha1/customers:listGcpProjectDeployments", + // "response": { + // "$ref": "SasPortalListGcpProjectDeploymentsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/sasportal" + // ] + // } + +} + // method id "prod_tt_sasportal.customers.listLegacyOrganizations": type CustomersListLegacyOrganizationsCall struct { @@ -2784,7 +2983,7 @@ type CustomersListLegacyOrganizationsCall struct { header_ http.Header } -// ListLegacyOrganizations: Checks whether account is legacy. +// ListLegacyOrganizations: Returns a list of legacy organizations. func (r *CustomersService) ListLegacyOrganizations() *CustomersListLegacyOrganizationsCall { c := &CustomersListLegacyOrganizationsCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -2888,7 +3087,7 @@ func (c *CustomersListLegacyOrganizationsCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Checks whether account is legacy.", + // "description": "Returns a list of legacy organizations.", // "flatPath": "v1alpha1/customers:listLegacyOrganizations", // "httpMethod": "GET", // "id": "prod_tt_sasportal.customers.listLegacyOrganizations", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json index 225eace9997..e01a742d494 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-api.json +++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json @@ -316,6 +316,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "reorder": { + "description": "Reorders all firewall policies.", + "flatPath": "v1/projects/{projectsId}/firewallpolicies:reorder", + "httpMethod": "POST", + "id": "recaptchaenterprise.projects.firewallpolicies.reorder", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The name of the project to list the policies for, in the format `projects/{project}`.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/firewallpolicies:reorder", + "request": { + "$ref": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest" + }, + "response": { + "$ref": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -666,7 +694,7 @@ } } }, - "revision": "20240101", + "revision": "20240113", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -1554,6 +1582,26 @@ }, "type": "object" }, + "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest": { + "description": "The reorder firewall policies request message.", + "id": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest", + "properties": { + "names": { + "description": "Required. A list containing all policy names, in the new order. Each name is in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse": { + "description": "The reorder firewall policies response message.", + "id": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse": { "description": "Secret key is used only in legacy reCAPTCHA. It must be used in a 3rd party integration with legacy reCAPTCHA.", "id": "GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go index 3a939190b19..92f4676e3f7 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go +++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go @@ -1815,6 +1815,45 @@ func (s *GoogleCloudRecaptchaenterpriseV1RelatedAccountGroupMembership) MarshalJ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest: The +// reorder firewall policies request message. +type GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest struct { + // Names: Required. A list containing all policy names, in the new + // order. Each name is in the format + // `projects/{project}/firewallpolicies/{firewallpolicy}`. + Names []string `json:"names,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Names") 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. "Names") 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 *GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse: The +// reorder firewall policies response message. +type GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse struct { + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` +} + // GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse: // Secret key is used only in legacy reCAPTCHA. It must be used in a 3rd // party integration with legacy reCAPTCHA. @@ -3970,6 +4009,152 @@ func (c *ProjectsFirewallpoliciesPatchCall) Do(opts ...googleapi.CallOption) (*G } +// method id "recaptchaenterprise.projects.firewallpolicies.reorder": + +type ProjectsFirewallpoliciesReorderCall struct { + s *Service + parent string + googlecloudrecaptchaenterprisev1reorderfirewallpoliciesrequest *GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Reorder: Reorders all firewall policies. +// +// - parent: The name of the project to list the policies for, in the +// format `projects/{project}`. +func (r *ProjectsFirewallpoliciesService) Reorder(parent string, googlecloudrecaptchaenterprisev1reorderfirewallpoliciesrequest *GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest) *ProjectsFirewallpoliciesReorderCall { + c := &ProjectsFirewallpoliciesReorderCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudrecaptchaenterprisev1reorderfirewallpoliciesrequest = googlecloudrecaptchaenterprisev1reorderfirewallpoliciesrequest + 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 *ProjectsFirewallpoliciesReorderCall) Fields(s ...googleapi.Field) *ProjectsFirewallpoliciesReorderCall { + 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 *ProjectsFirewallpoliciesReorderCall) Context(ctx context.Context) *ProjectsFirewallpoliciesReorderCall { + 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 *ProjectsFirewallpoliciesReorderCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsFirewallpoliciesReorderCall) 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.googlecloudrecaptchaenterprisev1reorderfirewallpoliciesrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/firewallpolicies:reorder") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "recaptchaenterprise.projects.firewallpolicies.reorder" call. +// Exactly one of +// *GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse.Serve +// rResponse.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 *ProjectsFirewallpoliciesReorderCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse{ + 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": "Reorders all firewall policies.", + // "flatPath": "v1/projects/{projectsId}/firewallpolicies:reorder", + // "httpMethod": "POST", + // "id": "recaptchaenterprise.projects.firewallpolicies.reorder", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The name of the project to list the policies for, in the format `projects/{project}`.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/firewallpolicies:reorder", + // "request": { + // "$ref": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest" + // }, + // "response": { + // "$ref": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "recaptchaenterprise.projects.keys.create": type ProjectsKeysCreateCall struct {