From 2c6dcc60cce8aebcf87bced4541644dce95d44ae Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sun, 6 Oct 2024 00:24:22 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2814) --- apigee/v1/apigee-api.json | 86 +++++- apigee/v1/apigee-gen.go | 271 ++++++++++++++++++ chat/v1/chat-api.json | 42 +-- chat/v1/chat-gen.go | 185 +++++++----- chromemanagement/v1/chromemanagement-api.json | 4 +- chromemanagement/v1/chromemanagement-gen.go | 2 +- chromepolicy/v1/chromepolicy-api.json | 6 +- chromepolicy/v1/chromepolicy-gen.go | 6 +- container/v1/container-api.json | 78 ++++- container/v1/container-gen.go | 70 +++++ .../v1alpha/firebaseappdistribution-api.json | 33 ++- .../v1alpha/firebaseappdistribution-gen.go | 117 ++++++++ firebaseml/v2beta/firebaseml-api.json | 8 +- firebaseml/v2beta/firebaseml-gen.go | 14 +- language/v1/language-api.json | 28 +- language/v1/language-gen.go | 13 + language/v1beta2/language-api.json | 28 +- language/v1beta2/language-gen.go | 13 + language/v2/language-api.json | 39 ++- language/v2/language-gen.go | 26 ++ searchads360/v0/searchads360-api.json | 102 ++++++- searchads360/v0/searchads360-gen.go | 118 +++++++- speech/v1/speech-api.json | 8 +- speech/v1/speech-gen.go | 2 + speech/v1p1beta1/speech-api.json | 8 +- speech/v1p1beta1/speech-gen.go | 2 + storagetransfer/v1/storagetransfer-api.json | 14 +- storagetransfer/v1/storagetransfer-gen.go | 39 ++- 28 files changed, 1215 insertions(+), 147 deletions(-) diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index cee60c35492..edc75823e50 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -227,6 +227,31 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getControlPlaneAccess": { + "description": "Lists the service accounts allowed to access Apigee control plane directly for limited functionality. **Note**: Available to Apigee hybrid only.", + "flatPath": "v1/organizations/{organizationsId}/controlPlaneAccess", + "httpMethod": "GET", + "id": "apigee.organizations.getControlPlaneAccess", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the Control Plane Access. Use the following structure in your request: `organizations/{org}/controlPlaneAccess`", + "location": "path", + "pattern": "^organizations/[^/]+/controlPlaneAccess$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleCloudApigeeV1ControlPlaneAccess" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "getDeployedIngressConfig": { "description": "Gets the deployed ingress configuration for an organization.", "flatPath": "v1/organizations/{organizationsId}/deployedIngressConfig", @@ -479,6 +504,40 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "updateControlPlaneAccess": { + "description": "Updates the permissions required to allow Apigee runtime-plane components access to the control plane. Currently, the permissions required are to: 1. Allow runtime components to publish analytics data to the control plane. **Note**: Available to Apigee hybrid only.", + "flatPath": "v1/organizations/{organizationsId}/controlPlaneAccess", + "httpMethod": "PATCH", + "id": "apigee.organizations.updateControlPlaneAccess", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the ControlPlaneAccess. Format: \"organizations/{org}/controlPlaneAccess\"", + "location": "path", + "pattern": "^organizations/[^/]+/controlPlaneAccess$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "List of fields to be updated. Fields that can be updated: synchronizer_identities, publisher_identities.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleCloudApigeeV1ControlPlaneAccess" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "updateSecuritySettings": { "description": "UpdateSecuritySettings updates the current security settings for API Security.", "flatPath": "v1/organizations/{organizationsId}/securitySettings", @@ -10314,7 +10373,7 @@ } } }, - "revision": "20240927", + "revision": "20241004", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -12031,6 +12090,31 @@ }, "type": "object" }, + "GoogleCloudApigeeV1ControlPlaneAccess": { + "description": "ControlPlaneAccess is the request body and response body of UpdateControlPlaneAccess. and the response body of GetControlPlaneAccess. The input identities contains an array of service accounts to grant access to the respective control plane resource, with each service account specified using the following format: `serviceAccount:`***service-account-name***. The ***service-account-name*** is formatted like an email address. For example: `my-control-plane-service_account@my_project_id.iam.gserviceaccount.com` You might specify multiple service accounts, for example, if you have multiple environments and wish to assign a unique service account to each one.", + "id": "GoogleCloudApigeeV1ControlPlaneAccess", + "properties": { + "analyticsPublisherIdentities": { + "description": "Optional. Array of service accounts authorized to publish analytics data to the control plane (for the Message Processor component).", + "items": { + "type": "string" + }, + "type": "array" + }, + "name": { + "description": "Identifier. The resource name of the ControlPlaneAccess. Format: \"organizations/{org}/controlPlaneAccess\"", + "type": "string" + }, + "synchronizerIdentities": { + "description": "Optional. Array of service accounts to grant access to control plane resources (for the Synchronizer component). The service accounts must have **Apigee Synchronizer Manager** role. See also [Create service accounts](https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-the-service-accounts).", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudApigeeV1Credential": { "id": "GoogleCloudApigeeV1Credential", "properties": { diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 7accb98d120..1b894d69e32 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -3257,6 +3257,51 @@ func (s GoogleCloudApigeeV1ConnectorsPlatformConfig) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1ControlPlaneAccess: ControlPlaneAccess is the request +// body and response body of UpdateControlPlaneAccess. and the response body of +// GetControlPlaneAccess. The input identities contains an array of service +// accounts to grant access to the respective control plane resource, with each +// service account specified using the following format: +// `serviceAccount:`***service-account-name***. The ***service-account-name*** +// is formatted like an email address. For example: +// `my-control-plane-service_account@my_project_id.iam.gserviceaccount.com` You +// might specify multiple service accounts, for example, if you have multiple +// environments and wish to assign a unique service account to each one. +type GoogleCloudApigeeV1ControlPlaneAccess struct { + // AnalyticsPublisherIdentities: Optional. Array of service accounts authorized + // to publish analytics data to the control plane (for the Message Processor + // component). + AnalyticsPublisherIdentities []string `json:"analyticsPublisherIdentities,omitempty"` + // Name: Identifier. The resource name of the ControlPlaneAccess. Format: + // "organizations/{org}/controlPlaneAccess" + Name string `json:"name,omitempty"` + // SynchronizerIdentities: Optional. Array of service accounts to grant access + // to control plane resources (for the Synchronizer component). The service + // accounts must have **Apigee Synchronizer Manager** role. See also Create + // service accounts + // (https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-the-service-accounts). + SynchronizerIdentities []string `json:"synchronizerIdentities,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. + // "AnalyticsPublisherIdentities") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AnalyticsPublisherIdentities") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudApigeeV1ControlPlaneAccess) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1ControlPlaneAccess + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type GoogleCloudApigeeV1Credential struct { // ApiProducts: List of API products this credential can be used for. ApiProducts []*GoogleCloudApigeeV1ApiProductRef `json:"apiProducts,omitempty"` @@ -12170,6 +12215,117 @@ func (c *OrganizationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApi return ret, nil } +type OrganizationsGetControlPlaneAccessCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetControlPlaneAccess: Lists the service accounts allowed to access Apigee +// control plane directly for limited functionality. **Note**: Available to +// Apigee hybrid only. +// +// - name: Resource name of the Control Plane Access. Use the following +// structure in your request: `organizations/{org}/controlPlaneAccess`. +func (r *OrganizationsService) GetControlPlaneAccess(name string) *OrganizationsGetControlPlaneAccessCall { + c := &OrganizationsGetControlPlaneAccessCall{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 +// details. +func (c *OrganizationsGetControlPlaneAccessCall) Fields(s ...googleapi.Field) *OrganizationsGetControlPlaneAccessCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an 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. +func (c *OrganizationsGetControlPlaneAccessCall) IfNoneMatch(entityTag string) *OrganizationsGetControlPlaneAccessCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsGetControlPlaneAccessCall) Context(ctx context.Context) *OrganizationsGetControlPlaneAccessCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsGetControlPlaneAccessCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsGetControlPlaneAccessCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.getControlPlaneAccess" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1ControlPlaneAccess.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 *OrganizationsGetControlPlaneAccessCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1ControlPlaneAccess, 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 := &GoogleCloudApigeeV1ControlPlaneAccess{ + 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 +} + type OrganizationsGetDeployedIngressConfigCall struct { s *Service name string @@ -13175,6 +13331,121 @@ func (c *OrganizationsUpdateCall) Do(opts ...googleapi.CallOption) (*GoogleCloud return ret, nil } +type OrganizationsUpdateControlPlaneAccessCall struct { + s *Service + name string + googlecloudapigeev1controlplaneaccess *GoogleCloudApigeeV1ControlPlaneAccess + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateControlPlaneAccess: Updates the permissions required to allow Apigee +// runtime-plane components access to the control plane. Currently, the +// permissions required are to: 1. Allow runtime components to publish +// analytics data to the control plane. **Note**: Available to Apigee hybrid +// only. +// +// - name: Identifier. The resource name of the ControlPlaneAccess. Format: +// "organizations/{org}/controlPlaneAccess". +func (r *OrganizationsService) UpdateControlPlaneAccess(name string, googlecloudapigeev1controlplaneaccess *GoogleCloudApigeeV1ControlPlaneAccess) *OrganizationsUpdateControlPlaneAccessCall { + c := &OrganizationsUpdateControlPlaneAccessCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudapigeev1controlplaneaccess = googlecloudapigeev1controlplaneaccess + return c +} + +// UpdateMask sets the optional parameter "updateMask": List of fields to be +// updated. Fields that can be updated: synchronizer_identities, +// publisher_identities. +func (c *OrganizationsUpdateControlPlaneAccessCall) UpdateMask(updateMask string) *OrganizationsUpdateControlPlaneAccessCall { + 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 +// details. +func (c *OrganizationsUpdateControlPlaneAccessCall) Fields(s ...googleapi.Field) *OrganizationsUpdateControlPlaneAccessCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsUpdateControlPlaneAccessCall) Context(ctx context.Context) *OrganizationsUpdateControlPlaneAccessCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsUpdateControlPlaneAccessCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsUpdateControlPlaneAccessCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudapigeev1controlplaneaccess) + if err != nil { + return nil, err + } + 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("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 "apigee.organizations.updateControlPlaneAccess" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsUpdateControlPlaneAccessCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type OrganizationsUpdateSecuritySettingsCall struct { s *Service name string diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index de69885b2e3..5ed53f6748a 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -290,7 +290,7 @@ ] }, "create": { - "description": "Creates a space with no members. Can be used to create a named space. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. If you're a member of the [Developer Preview program](https://developers.google.com/workspace/preview), you can create a group chat in import mode using `spaceType.GROUP_CHAT`. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Creates a space with no members. Can be used to create a named space. Spaces grouped by topics aren't supported. For an example, see [Create a space](https://developers.google.com/workspace/chat/create-spaces). If you receive the error message `ALREADY_EXISTS` when creating a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. If you're a member of the [Developer Preview program](https://developers.google.com/workspace/preview), you can create a group chat in import mode using `spaceType.GROUP_CHAT`. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) When authenticating as an app, the `space.customer` field must be set in the request.", "flatPath": "v1/spaces", "httpMethod": "POST", "id": "chat.spaces.create", @@ -318,7 +318,7 @@ ] }, "delete": { - "description": "Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) from a user who has permission to delete the space.", + "description": "Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}", "httpMethod": "DELETE", "id": "chat.spaces.delete", @@ -351,7 +351,7 @@ ] }, "findDirectMessage": { - "description": "Returns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), returns the direct message space between the specified user and the authenticated user. With [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) or [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).", + "description": "Returns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message). With [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app. With [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), returns the direct message space between the specified user and the authenticated user. // Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces:findDirectMessage", "httpMethod": "GET", "id": "chat.spaces.findDirectMessage", @@ -374,7 +374,7 @@ ] }, "get": { - "description": "Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Returns details about a space. For an example, see [Get details about a space](https://developers.google.com/workspace/chat/get-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}", "httpMethod": "GET", "id": "chat.spaces.get", @@ -409,7 +409,7 @@ ] }, "list": { - "description": "Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list-spaces). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent. To list all named spaces by Google Workspace organization, use the [`spaces.search()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search) method using Workspace administrator privileges instead.", + "description": "Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent. To list all named spaces by Google Workspace organization, use the [`spaces.search()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search) method using Workspace administrator privileges instead.", "flatPath": "v1/spaces", "httpMethod": "GET", "id": "chat.spaces.list", @@ -443,7 +443,7 @@ ] }, "patch": { - "description": "Updates a space. For an example, see [Update a space](https://developers.google.com/workspace/chat/update-spaces). If you're updating the `displayName` field and receive the error message `ALREADY_EXISTS`, try a different display name.. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Updates a space. For an example, see [Update a space](https://developers.google.com/workspace/chat/update-spaces). If you're updating the `displayName` field and receive the error message `ALREADY_EXISTS`, try a different display name.. An existing space within the Google Workspace organization might already use this display name. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}", "httpMethod": "PATCH", "id": "chat.spaces.patch", @@ -551,7 +551,7 @@ "members": { "methods": { "create": { - "description": "Creates a membership for the calling Chat app, a user, or a Google Group. Creating memberships for other Chat apps isn't supported. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). For example usage, see: - [Invite or add a user to a space](https://developers.google.com/workspace/chat/create-members#create-user-membership). - [Invite or add a Google Group to a space](https://developers.google.com/workspace/chat/create-members#create-group-membership). - [Add the Chat app to a space](https://developers.google.com/workspace/chat/create-members#create-membership-calling-api).", + "description": "Creates a membership for the calling Chat app, a user, or a Google Group. Creating memberships for other Chat apps isn't supported. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) For example usage, see: - [Invite or add a user to a space](https://developers.google.com/workspace/chat/create-members#create-user-membership). - [Invite or add a Google Group to a space](https://developers.google.com/workspace/chat/create-members#create-group-membership). - [Add the Chat app to a space](https://developers.google.com/workspace/chat/create-members#create-membership-calling-api).", "flatPath": "v1/spaces/{spacesId}/members", "httpMethod": "POST", "id": "chat.spaces.members.create", @@ -588,7 +588,7 @@ ] }, "delete": { - "description": "Deletes a membership. For an example, see [Remove a user or a Google Chat app from a space](https://developers.google.com/workspace/chat/delete-members). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Deletes a membership. For an example, see [Remove a user or a Google Chat app from a space](https://developers.google.com/workspace/chat/delete-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}/members/{membersId}", "httpMethod": "DELETE", "id": "chat.spaces.members.delete", @@ -622,7 +622,7 @@ ] }, "get": { - "description": "Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}/members/{membersId}", "httpMethod": "GET", "id": "chat.spaces.members.get", @@ -631,7 +631,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name of the membership to retrieve. To get the app's own membership [by using user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app` When [authenticated as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can use the user's email as an alias for `{member}`. For example, `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user.", + "description": "Required. Resource name of the membership to retrieve. To get the app's own membership [by using user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app` You can use the user's email as an alias for `{member}`. For example, `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user.", "location": "path", "pattern": "^spaces/[^/]+/members/[^/]+$", "required": true, @@ -656,7 +656,7 @@ ] }, "list": { - "description": "Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}/members", "httpMethod": "GET", "id": "chat.spaces.members.list", @@ -717,7 +717,7 @@ ] }, "patch": { - "description": "Updates a membership. For an example, see [Update a user's membership in a space](https://developers.google.com/workspace/chat/update-members). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Updates a membership. For an example, see [Update a user's membership in a space](https://developers.google.com/workspace/chat/update-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "flatPath": "v1/spaces/{spacesId}/members/{membersId}", "httpMethod": "PATCH", "id": "chat.spaces.members.patch", @@ -825,7 +825,7 @@ ] }, "delete": { - "description": "Deletes a message. For an example, see [Delete a message](https://developers.google.com/workspace/chat/delete-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only delete messages created by the calling Chat app.", + "description": "Deletes a message. For an example, see [Delete a message](https://developers.google.com/workspace/chat/delete-messages). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) When using app authentication, requests can only delete messages created by the calling Chat app.", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "DELETE", "id": "chat.spaces.messages.delete", @@ -857,7 +857,7 @@ ] }, "get": { - "description": "Returns details about a message. For an example, see [Get details about a message](https://developers.google.com/workspace/chat/get-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Note: Might return a message from a blocked member or space.", + "description": "Returns details about a message. For an example, see [Get details about a message](https://developers.google.com/workspace/chat/get-messages). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) Note: Might return a message from a blocked member or space.", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "GET", "id": "chat.spaces.messages.get", @@ -937,7 +937,7 @@ ] }, "patch": { - "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/workspace/chat/update-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only update messages created by the calling Chat app.", + "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/workspace/chat/update-messages). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) When using app authentication, requests can only update messages created by the calling Chat app.", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "PATCH", "id": "chat.spaces.messages.patch", @@ -978,7 +978,7 @@ ] }, "update": { - "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/workspace/chat/update-messages). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). When using app authentication, requests can only update messages created by the calling Chat app.", + "description": "Updates a message. There's a difference between the `patch` and `update` methods. The `patch` method uses a `patch` request while the `update` method uses a `put` request. We recommend using the `patch` method. For an example, see [Update a message](https://developers.google.com/workspace/chat/update-messages). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) When using app authentication, requests can only update messages created by the calling Chat app.", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "PUT", "id": "chat.spaces.messages.update", @@ -1344,7 +1344,7 @@ } } }, - "revision": "20240926", + "revision": "20241001", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -1361,13 +1361,13 @@ "enumDescriptions": [ "Access state is unknown or not supported in this API.", "Only users or Google Groups that have been individually added or invited by other users or Google Workspace administrators can discover and access the space.", - "A space manager has granted a target audience access to the space. Users or Google Groups that have been individually added or invited to the space can also discover and access the space. To learn more, see [Make a space discoverable to specific users](https://developers.google.com/workspace/chat/space-target-audience)." + "A space manager has granted a target audience access to the space. Users or Google Groups that have been individually added or invited to the space can also discover and access the space. To learn more, see [Make a space discoverable to specific users](https://developers.google.com/workspace/chat/space-target-audience). Creating discoverable spaces requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)." ], "readOnly": true, "type": "string" }, "audience": { - "description": "Optional. The resource name of the [target audience](https://support.google.com/a/answer/9934697) who can discover the space, join the space, and preview the messages in the space. If unset, only users or Google Groups who have been individually invited or added to the space can access it. For details, see [Make a space discoverable to a target audience](https://developers.google.com/workspace/chat/space-target-audience). Format: `audiences/{audience}` To use the default target audience for the Google Workspace organization, set to `audiences/default`. This field is not populated when using the `chat.bot` scope with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).", + "description": "Optional. The resource name of the [target audience](https://support.google.com/a/answer/9934697) who can discover the space, join the space, and preview the messages in the space. If unset, only users or Google Groups who have been individually invited or added to the space can access it. For details, see [Make a space discoverable to a target audience](https://developers.google.com/workspace/chat/space-target-audience). Format: `audiences/{audience}` To use the default target audience for the Google Workspace organization, set to `audiences/default`. Reading the target audience supports: - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) with the `chat.app.spaces` scope in [Developer Preview](https://developers.google.com/workspace/preview). This field is not populated when using the `chat.bot` scope with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). Setting the target audience requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "type": "string" } }, @@ -3607,7 +3607,7 @@ }, "groupMember": { "$ref": "Group", - "description": "The Google Group the membership corresponds to." + "description": "The Google Group the membership corresponds to. Reading or mutating memberships for Google Groups requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)." }, "member": { "$ref": "User", @@ -4323,7 +4323,7 @@ "type": "boolean" }, "importMode": { - "description": "Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete.", + "description": "Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "type": "boolean" }, "lastActiveTime": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index d3a2c7ef62b..79ec787e703 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -403,6 +403,9 @@ type AccessSettings struct { // invited to the space can also discover and access the space. To learn more, // see [Make a space discoverable to specific // users](https://developers.google.com/workspace/chat/space-target-audience). + // Creating discoverable spaces requires [user + // authentication](https://developers.google.com/workspace/chat/authenticate-aut + // horize-chat-user). AccessState string `json:"accessState,omitempty"` // Audience: Optional. The resource name of the target audience // (https://support.google.com/a/answer/9934697) who can discover the space, @@ -412,9 +415,18 @@ type AccessSettings struct { // audience // (https://developers.google.com/workspace/chat/space-target-audience). // Format: `audiences/{audience}` To use the default target audience for the - // Google Workspace organization, set to `audiences/default`. This field is not + // Google Workspace organization, set to `audiences/default`. Reading the + // target audience supports: - User authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) + // - App authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) + // with administrator approval (https://support.google.com/a?p=chat-app-auth) + // with the `chat.app.spaces` scope in Developer Preview + // (https://developers.google.com/workspace/preview). This field is not // populated when using the `chat.bot` scope with app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). + // Setting the target audience requires user authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Audience string `json:"audience,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessState") to // unconditionally include in API requests. By default, fields with empty or @@ -3769,7 +3781,9 @@ type Membership struct { // only, except when used to import historical memberships in import mode // spaces. DeleteTime string `json:"deleteTime,omitempty"` - // GroupMember: The Google Group the membership corresponds to. + // GroupMember: The Google Group the membership corresponds to. Reading or + // mutating memberships for Google Groups requires user authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). GroupMember *Group `json:"groupMember,omitempty"` // Member: The Google Chat user or app the membership corresponds to. If your // Chat app authenticates as a user @@ -4832,7 +4846,9 @@ type Space struct { ExternalUserAllowed bool `json:"externalUserAllowed,omitempty"` // ImportMode: Optional. Whether this space is created in `Import Mode` as part // of a data migration into Google Workspace. While spaces are being imported, - // they aren't visible to users until the import is complete. + // they aren't visible to users until the import is complete. Creating a space + // in `Import Mode`requires user authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). ImportMode bool `json:"importMode,omitempty"` // LastActiveTime: Output only. Timestamp of the last message in the space. LastActiveTime string `json:"lastActiveTime,omitempty"` @@ -6024,8 +6040,16 @@ type SpacesCreateCall struct { // organization might already use this display name. If you're a member of the // Developer Preview program (https://developers.google.com/workspace/preview), // you can create a group chat in import mode using `spaceType.GROUP_CHAT`. -// Requires user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// with administrator approval (https://support.google.com/a?p=chat-app-auth) +// in Developer Preview (https://developers.google.com/workspace/preview) - +// User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) +// When authenticating as an app, the `space.customer` field must be set in the +// request. func (r *SpacesService) Create(space *Space) *SpacesCreateCall { c := &SpacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.space = space @@ -6133,9 +6157,14 @@ type SpacesDeleteCall struct { // means that the space's child resources—like messages posted in the space // and memberships in the space—are also deleted. For an example, see Delete // a space (https://developers.google.com/workspace/chat/delete-spaces). -// Requires user authentication +// Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// with administrator approval (https://support.google.com/a?p=chat-app-auth) +// in Developer Preview (https://developers.google.com/workspace/preview) - +// User authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) -// from a user who has permission to delete the space. // // - name: Resource name of the space to delete. Format: `spaces/{space}`. func (r *SpacesService) Delete(name string) *SpacesDeleteCall { @@ -6245,16 +6274,18 @@ type SpacesFindDirectMessageCall struct { // FindDirectMessage: Returns the existing direct message with the specified // user. If no direct message space is found, returns a `404 NOT_FOUND` error. // For an example, see Find a direct message -// (/chat/api/guides/v1/spaces/find-direct-message). With user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), -// returns the direct message space between the specified user and the -// authenticated user. With app authentication +// (/chat/api/guides/v1/spaces/find-direct-message). With app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), // returns the direct message space between the specified user and the calling -// Chat app. Requires user authentication +// Chat app. With user authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), +// returns the direct message space between the specified user and the +// authenticated user. // Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// - User authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) -// or app authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). func (r *SpacesService) FindDirectMessage() *SpacesFindDirectMessageCall { c := &SpacesFindDirectMessageCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -6374,13 +6405,13 @@ type SpacesGetCall struct { } // Get: Returns details about a space. For an example, see Get details about a -// space (https://developers.google.com/workspace/chat/get-spaces). Requires +// space (https://developers.google.com/workspace/chat/get-spaces). Supports +// the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // - name: Resource name of the space, in the form `spaces/{space}`. Format: // `spaces/{space}`. @@ -6501,13 +6532,13 @@ type SpacesListCall struct { // List: Lists spaces the caller is a member of. Group chats and DMs aren't // listed until the first message is sent. For an example, see List spaces -// (https://developers.google.com/workspace/chat/list-spaces). Requires +// (https://developers.google.com/workspace/chat/list-spaces). Supports the +// following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // Lists spaces visible to the caller or authenticated user. Group chats and // DMs aren't listed until the first message is sent. To list all named spaces // by Google Workspace organization, use the `spaces.search()` @@ -6674,8 +6705,14 @@ type SpacesPatchCall struct { // updating the `displayName` field and receive the error message // `ALREADY_EXISTS`, try a different display name.. An existing space within // the Google Workspace organization might already use this display name. -// Requires user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// with administrator approval (https://support.google.com/a?p=chat-app-auth) +// in Developer Preview (https://developers.google.com/workspace/preview) - +// User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // - name: Resource name of the space. Format: `spaces/{space}` Where `{space}` // represents the system-assigned ID for the space. You can obtain the space @@ -7167,8 +7204,14 @@ type SpacesMembersCreateCall struct { // creating a membership, if the specified member has their auto-accept policy // turned off, then they're invited, and must accept the space invitation // before joining. Otherwise, creating a membership adds the member directly to -// the specified space. Requires user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// the specified space. Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// with administrator approval (https://support.google.com/a?p=chat-app-auth) +// in Developer Preview (https://developers.google.com/workspace/preview) - +// User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // For example usage, see: - Invite or add a user to a space // (https://developers.google.com/workspace/chat/create-members#create-user-membership). // - Invite or add a Google Group to a space @@ -7292,9 +7335,15 @@ type SpacesMembersDeleteCall struct { // Delete: Deletes a membership. For an example, see Remove a user or a Google // Chat app from a space -// (https://developers.google.com/workspace/chat/delete-members). Requires user +// (https://developers.google.com/workspace/chat/delete-members). Supports the +// following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// with administrator approval (https://support.google.com/a?p=chat-app-auth) +// in Developer Preview (https://developers.google.com/workspace/preview) - +// User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // - name: Resource name of the membership to delete. Chat apps can delete // human users' or their own memberships. Chat apps can't delete other apps' @@ -7414,22 +7463,20 @@ type SpacesMembersGetCall struct { // Get: Returns details about a membership. For an example, see Get details // about a user's or Google Chat app's membership -// (https://developers.google.com/workspace/chat/get-members). Requires +// (https://developers.google.com/workspace/chat/get-members). Supports the +// following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // - name: Resource name of the membership to retrieve. To get the app's own // membership by using user authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), // you can optionally use `spaces/{space}/members/app`. Format: -// `spaces/{space}/members/{member}` or `spaces/{space}/members/app` When -// authenticated as a user -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), -// you can use the user's email as an alias for `{member}`. For example, +// `spaces/{space}/members/{member}` or `spaces/{space}/members/app` You can +// use the user's email as an alias for `{member}`. For example, // `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is // the email of the Google Chat user. func (r *SpacesMembersService) Get(name string) *SpacesMembersGetCall { @@ -7560,12 +7607,12 @@ type SpacesMembersListCall struct { // authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // lists memberships in spaces that the authenticated user has access to. -// Requires authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication +// Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // - parent: The resource name of the space for which to fetch a membership // list. Format: spaces/{space}. @@ -7773,8 +7820,14 @@ type SpacesMembersPatchCall struct { // Patch: Updates a membership. For an example, see Update a user's membership // in a space (https://developers.google.com/workspace/chat/update-members). -// Requires user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) +// with administrator approval (https://support.google.com/a?p=chat-app-auth) +// in Developer Preview (https://developers.google.com/workspace/preview) - +// User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // - name: Resource name of the membership, assigned by the server. Format: // `spaces/{space}/members/{member}`. @@ -8072,13 +8125,13 @@ type SpacesMessagesDeleteCall struct { } // Delete: Deletes a message. For an example, see Delete a message -// (https://developers.google.com/workspace/chat/delete-messages). Requires +// (https://developers.google.com/workspace/chat/delete-messages). Supports the +// following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // When using app authentication, requests can only delete messages created by // the calling Chat app. // @@ -8193,12 +8246,12 @@ type SpacesMessagesGetCall struct { // Get: Returns details about a message. For an example, see Get details about // a message (https://developers.google.com/workspace/chat/get-messages). -// Requires authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication +// Supports the following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App +// authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // Note: Might return a message from a blocked member or space. // // - name: Resource name of the message. Format: @@ -8513,13 +8566,13 @@ type SpacesMessagesPatchCall struct { // `update` methods. The `patch` method uses a `patch` request while the // `update` method uses a `put` request. We recommend using the `patch` method. // For an example, see Update a message -// (https://developers.google.com/workspace/chat/update-messages). Requires +// (https://developers.google.com/workspace/chat/update-messages). Supports the +// following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // When using app authentication, requests can only update messages created by // the calling Chat app. // @@ -8659,13 +8712,13 @@ type SpacesMessagesUpdateCall struct { // `update` methods. The `patch` method uses a `patch` request while the // `update` method uses a `put` request. We recommend using the `patch` method. // For an example, see Update a message -// (https://developers.google.com/workspace/chat/update-messages). Requires +// (https://developers.google.com/workspace/chat/update-messages). Supports the +// following types of authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - App // authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize). -// Supports app authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// and user authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). +// - User authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // When using app authentication, requests can only update messages created by // the calling Chat app. // diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 0729fbad566..aadd4724366 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -9,7 +9,7 @@ "description": "See reports about devices and Chrome browsers managed within your organization" }, "https://www.googleapis.com/auth/chrome.management.telemetry.readonly": { - "description": "See basic device and telemetry information collected from Chrome OS devices or users managed within your organization" + "description": "See basic device and telemetry information collected from ChromeOS devices or users managed within your organization" } } } @@ -1172,7 +1172,7 @@ } } }, - "revision": "20241001", + "revision": "20241003", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index d2eeaeec15b..d10adf7ff5d 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -108,7 +108,7 @@ const ( // organization ChromeManagementReportsReadonlyScope = "https://www.googleapis.com/auth/chrome.management.reports.readonly" - // See basic device and telemetry information collected from Chrome OS devices + // See basic device and telemetry information collected from ChromeOS devices // or users managed within your organization ChromeManagementTelemetryReadonlyScope = "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ) diff --git a/chromepolicy/v1/chromepolicy-api.json b/chromepolicy/v1/chromepolicy-api.json index e9dd08bedef..6005ea1ddaf 100644 --- a/chromepolicy/v1/chromepolicy-api.json +++ b/chromepolicy/v1/chromepolicy-api.json @@ -3,10 +3,10 @@ "oauth2": { "scopes": { "https://www.googleapis.com/auth/chrome.management.policy": { - "description": "See, edit, create or delete policies applied to Chrome OS and Chrome Browsers managed within your organization" + "description": "See, edit, create or delete policies applied to ChromeOS and Chrome Browsers managed within your organization" }, "https://www.googleapis.com/auth/chrome.management.policy.readonly": { - "description": "See policies applied to Chrome OS and Chrome Browsers managed within your organization" + "description": "See policies applied to ChromeOS and Chrome Browsers managed within your organization" } } } @@ -557,7 +557,7 @@ } } }, - "revision": "20240729", + "revision": "20241004", "rootUrl": "https://chromepolicy.googleapis.com/", "schemas": { "GoogleChromePolicyVersionsV1AdditionalTargetKeyName": { diff --git a/chromepolicy/v1/chromepolicy-gen.go b/chromepolicy/v1/chromepolicy-gen.go index f90cbef5f0d..b3c3948c99c 100644 --- a/chromepolicy/v1/chromepolicy-gen.go +++ b/chromepolicy/v1/chromepolicy-gen.go @@ -100,11 +100,11 @@ const mtlsBasePath = "https://chromepolicy.mtls.googleapis.com/" // OAuth2 scopes used by this API. const ( - // See, edit, create or delete policies applied to Chrome OS and Chrome - // Browsers managed within your organization + // See, edit, create or delete policies applied to ChromeOS and Chrome Browsers + // managed within your organization ChromeManagementPolicyScope = "https://www.googleapis.com/auth/chrome.management.policy" - // See policies applied to Chrome OS and Chrome Browsers managed within your + // See policies applied to ChromeOS and Chrome Browsers managed within your // organization ChromeManagementPolicyReadonlyScope = "https://www.googleapis.com/auth/chrome.management.policy.readonly" ) diff --git a/container/v1/container-api.json b/container/v1/container-api.json index 23ee83811c3..ca847aaf11e 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -2540,7 +2540,7 @@ } } }, - "revision": "20240905", + "revision": "20240912", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3466,6 +3466,10 @@ "readOnly": true, "type": "string" }, + "userManagedKeysConfig": { + "$ref": "UserManagedKeysConfig", + "description": "The Custom keys configuration for the cluster." + }, "verticalPodAutoscaling": { "$ref": "VerticalPodAutoscaling", "description": "Cluster-level Vertical Pod Autoscaling configuration." @@ -3833,6 +3837,10 @@ "removedAdditionalPodRangesConfig": { "$ref": "AdditionalPodRangesConfig", "description": "The additional pod ranges that are to be removed from the cluster. The pod ranges specified here must have been specified earlier in the 'additional_pod_ranges_config' argument." + }, + "userManagedKeysConfig": { + "$ref": "UserManagedKeysConfig", + "description": "The Custom keys configuration for the cluster." } }, "type": "object" @@ -4896,7 +4904,9 @@ "WORKLOADS", "APISERVER", "SCHEDULER", - "CONTROLLER_MANAGER" + "CONTROLLER_MANAGER", + "KCP_SSHD", + "KCP_CONNECTION" ], "enumDescriptions": [ "Default value. This shouldn't be used.", @@ -4904,7 +4914,9 @@ "workloads", "kube-apiserver", "kube-scheduler", - "kube-controller-manager" + "kube-controller-manager", + "kcp-sshd", + "kcp connection logs" ], "type": "string" }, @@ -5421,6 +5433,21 @@ "description": "Type of the disk attached to each node (e.g. 'pd-standard', 'pd-ssd' or 'pd-balanced') If unspecified, the default disk type is 'pd-standard'", "type": "string" }, + "effectiveCgroupMode": { + "description": "Output only. effective_cgroup_mode is the cgroup mode actually used by the node pool. It is determined by the cgroup mode specified in the LinuxNodeConfig or the default cgroup mode based on the cluster creation version.", + "enum": [ + "EFFECTIVE_CGROUP_MODE_UNSPECIFIED", + "EFFECTIVE_CGROUP_MODE_V1", + "EFFECTIVE_CGROUP_MODE_V2" + ], + "enumDescriptions": [ + "EFFECTIVE_CGROUP_MODE_UNSPECIFIED means the cgroup configuration for the node pool is unspecified, i.e. the node pool is a Windows node pool.", + "CGROUP_MODE_V1 means the node pool is configured to use cgroupv1 for the cgroup configuration.", + "CGROUP_MODE_V2 means the node pool is configured to use cgroupv2 for the cgroup configuration." + ], + "readOnly": true, + "type": "string" + }, "enableConfidentialStorage": { "description": "Optional. Reserved for future use.", "type": "boolean" @@ -7889,6 +7916,51 @@ }, "type": "object" }, + "UserManagedKeysConfig": { + "description": "UserManagedKeysConfig holds the resource address to Keys which are used for signing certs and token that are used for communication within cluster.", + "id": "UserManagedKeysConfig", + "properties": { + "aggregationCa": { + "description": "The Certificate Authority Service caPool to use for the aggregation CA in this cluster.", + "type": "string" + }, + "clusterCa": { + "description": "The Certificate Authority Service caPool to use for the cluster CA in this cluster.", + "type": "string" + }, + "controlPlaneDiskEncryptionKey": { + "description": "The Cloud KMS cryptoKey to use for Confidential Hyperdisk on the control plane nodes.", + "type": "string" + }, + "etcdApiCa": { + "description": "Resource path of the Certificate Authority Service caPool to use for the etcd API CA in this cluster.", + "type": "string" + }, + "etcdPeerCa": { + "description": "Resource path of the Certificate Authority Service caPool to use for the etcd peer CA in this cluster.", + "type": "string" + }, + "gkeopsEtcdBackupEncryptionKey": { + "description": "Resource path of the Cloud KMS cryptoKey to use for encryption of internal etcd backups.", + "type": "string" + }, + "serviceAccountSigningKeys": { + "description": "The Cloud KMS cryptoKeyVersions to use for signing service account JWTs issued by this cluster. Format: `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{cryptoKey}/cryptoKeyVersions/{cryptoKeyVersion}`", + "items": { + "type": "string" + }, + "type": "array" + }, + "serviceAccountVerificationKeys": { + "description": "The Cloud KMS cryptoKeyVersions to use for verifying service account JWTs issued by this cluster. Format: `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{cryptoKey}/cryptoKeyVersions/{cryptoKeyVersion}`", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "VerticalPodAutoscaling": { "description": "VerticalPodAutoscaling contains global, per-cluster information required by Vertical Pod Autoscaler to automatically adjust the resources of pods controlled by it.", "id": "VerticalPodAutoscaling", diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 0acd9f16d65..c61ec6cd9d4 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -1332,6 +1332,8 @@ type Cluster struct { // (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. // `1.2.3.4/29`). TpuIpv4CidrBlock string `json:"tpuIpv4CidrBlock,omitempty"` + // UserManagedKeysConfig: The Custom keys configuration for the cluster. + UserManagedKeysConfig *UserManagedKeysConfig `json:"userManagedKeysConfig,omitempty"` // VerticalPodAutoscaling: Cluster-level Vertical Pod Autoscaling // configuration. VerticalPodAutoscaling *VerticalPodAutoscaling `json:"verticalPodAutoscaling,omitempty"` @@ -1664,6 +1666,8 @@ type ClusterUpdate struct { // removed from the cluster. The pod ranges specified here must have been // specified earlier in the 'additional_pod_ranges_config' argument. RemovedAdditionalPodRangesConfig *AdditionalPodRangesConfig `json:"removedAdditionalPodRangesConfig,omitempty"` + // UserManagedKeysConfig: The Custom keys configuration for the cluster. + UserManagedKeysConfig *UserManagedKeysConfig `json:"userManagedKeysConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalPodRangesConfig") // to unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -3235,6 +3239,8 @@ type LoggingComponentConfig struct { // "APISERVER" - kube-apiserver // "SCHEDULER" - kube-scheduler // "CONTROLLER_MANAGER" - kube-controller-manager + // "KCP_SSHD" - kcp-sshd + // "KCP_CONNECTION" - kcp connection logs EnableComponents []string `json:"enableComponents,omitempty"` // ForceSendFields is a list of field names (e.g. "EnableComponents") to // unconditionally include in API requests. By default, fields with empty or @@ -3925,6 +3931,20 @@ type NodeConfig struct { // 'pd-ssd' or 'pd-balanced') If unspecified, the default disk type is // 'pd-standard' DiskType string `json:"diskType,omitempty"` + // EffectiveCgroupMode: Output only. effective_cgroup_mode is the cgroup mode + // actually used by the node pool. It is determined by the cgroup mode + // specified in the LinuxNodeConfig or the default cgroup mode based on the + // cluster creation version. + // + // Possible values: + // "EFFECTIVE_CGROUP_MODE_UNSPECIFIED" - EFFECTIVE_CGROUP_MODE_UNSPECIFIED + // means the cgroup configuration for the node pool is unspecified, i.e. the + // node pool is a Windows node pool. + // "EFFECTIVE_CGROUP_MODE_V1" - CGROUP_MODE_V1 means the node pool is + // configured to use cgroupv1 for the cgroup configuration. + // "EFFECTIVE_CGROUP_MODE_V2" - CGROUP_MODE_V2 means the node pool is + // configured to use cgroupv2 for the cgroup configuration. + EffectiveCgroupMode string `json:"effectiveCgroupMode,omitempty"` // EnableConfidentialStorage: Optional. Reserved for future use. EnableConfidentialStorage bool `json:"enableConfidentialStorage,omitempty"` // EphemeralStorageLocalSsdConfig: Parameters for the node ephemeral storage @@ -7109,6 +7129,56 @@ func (s UsableSubnetworkSecondaryRange) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UserManagedKeysConfig: UserManagedKeysConfig holds the resource address to +// Keys which are used for signing certs and token that are used for +// communication within cluster. +type UserManagedKeysConfig struct { + // AggregationCa: The Certificate Authority Service caPool to use for the + // aggregation CA in this cluster. + AggregationCa string `json:"aggregationCa,omitempty"` + // ClusterCa: The Certificate Authority Service caPool to use for the cluster + // CA in this cluster. + ClusterCa string `json:"clusterCa,omitempty"` + // ControlPlaneDiskEncryptionKey: The Cloud KMS cryptoKey to use for + // Confidential Hyperdisk on the control plane nodes. + ControlPlaneDiskEncryptionKey string `json:"controlPlaneDiskEncryptionKey,omitempty"` + // EtcdApiCa: Resource path of the Certificate Authority Service caPool to use + // for the etcd API CA in this cluster. + EtcdApiCa string `json:"etcdApiCa,omitempty"` + // EtcdPeerCa: Resource path of the Certificate Authority Service caPool to use + // for the etcd peer CA in this cluster. + EtcdPeerCa string `json:"etcdPeerCa,omitempty"` + // GkeopsEtcdBackupEncryptionKey: Resource path of the Cloud KMS cryptoKey to + // use for encryption of internal etcd backups. + GkeopsEtcdBackupEncryptionKey string `json:"gkeopsEtcdBackupEncryptionKey,omitempty"` + // ServiceAccountSigningKeys: The Cloud KMS cryptoKeyVersions to use for + // signing service account JWTs issued by this cluster. Format: + // `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{crypt + // oKey}/cryptoKeyVersions/{cryptoKeyVersion}` + ServiceAccountSigningKeys []string `json:"serviceAccountSigningKeys,omitempty"` + // ServiceAccountVerificationKeys: The Cloud KMS cryptoKeyVersions to use for + // verifying service account JWTs issued by this cluster. Format: + // `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{crypt + // oKey}/cryptoKeyVersions/{cryptoKeyVersion}` + ServiceAccountVerificationKeys []string `json:"serviceAccountVerificationKeys,omitempty"` + // ForceSendFields is a list of field names (e.g. "AggregationCa") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AggregationCa") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserManagedKeysConfig) MarshalJSON() ([]byte, error) { + type NoMethod UserManagedKeysConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // VerticalPodAutoscaling: VerticalPodAutoscaling contains global, per-cluster // information required by Vertical Pod Autoscaler to automatically adjust the // resources of pods controlled by it. diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json index 39884eea546..2b53fa39bb1 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json @@ -448,6 +448,31 @@ "resources": { "tests": { "methods": { + "cancel": { + "description": "Abort automated test run on release.", + "flatPath": "v1alpha/projects/{projectsId}/apps/{appsId}/releases/{releasesId}/tests/{testsId}:cancel", + "httpMethod": "GET", + "id": "firebaseappdistribution.projects.apps.releases.tests.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the release test resource. Format: `projects/{project_number}/apps/{app_id}/releases/{release_id}/tests/{test_id}`", + "location": "path", + "pattern": "^projects/[^/]+/apps/[^/]+/releases/[^/]+/tests/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:cancel", + "response": { + "$ref": "GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Run automated test(s) on release.", "flatPath": "v1alpha/projects/{projectsId}/apps/{appsId}/releases/{releasesId}/tests", @@ -585,7 +610,7 @@ } } }, - "revision": "20241003", + "revision": "20241004", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { @@ -874,6 +899,12 @@ }, "type": "object" }, + "GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse": { + "description": "The (empty) response message for `CancelReleaseTest`.", + "id": "GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse", + "properties": {}, + "type": "object" + }, "GoogleFirebaseAppdistroV1alphaCreateReleaseNotesRequest": { "id": "GoogleFirebaseAppdistroV1alphaCreateReleaseNotesRequest", "properties": { diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go index 1c6a4da322b..895fc0f8e99 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go @@ -624,6 +624,13 @@ func (s GoogleFirebaseAppdistroV1alphaAssertionDetails) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse: The (empty) +// response message for `CancelReleaseTest`. +type GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse struct { + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` +} + type GoogleFirebaseAppdistroV1alphaCreateReleaseNotesRequest struct { // ReleaseNotes: The actual release notes body from the user ReleaseNotes *GoogleFirebaseAppdistroV1alphaReleaseNotes `json:"releaseNotes,omitempty"` @@ -2587,6 +2594,116 @@ func (c *ProjectsAppsUpdateTestConfigCall) Do(opts ...googleapi.CallOption) (*Go return ret, nil } +type ProjectsAppsReleasesTestsCancelCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Cancel: Abort automated test run on release. +// +// - name: The name of the release test resource. Format: +// `projects/{project_number}/apps/{app_id}/releases/{release_id}/tests/{test_ +// id}`. +func (r *ProjectsAppsReleasesTestsService) Cancel(name string) *ProjectsAppsReleasesTestsCancelCall { + c := &ProjectsAppsReleasesTestsCancelCall{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 +// details. +func (c *ProjectsAppsReleasesTestsCancelCall) Fields(s ...googleapi.Field) *ProjectsAppsReleasesTestsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an 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. +func (c *ProjectsAppsReleasesTestsCancelCall) IfNoneMatch(entityTag string) *ProjectsAppsReleasesTestsCancelCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsAppsReleasesTestsCancelCall) Context(ctx context.Context) *ProjectsAppsReleasesTestsCancelCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsAppsReleasesTestsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsAppsReleasesTestsCancelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + 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}:cancel") + 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 "firebaseappdistribution.projects.apps.releases.tests.cancel" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse.ServerResponse.Heade +// r 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 *ProjectsAppsReleasesTestsCancelCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse, 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 := &GoogleFirebaseAppdistroV1alphaCancelReleaseTestResponse{ + 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 +} + type ProjectsAppsReleasesTestsCreateCall struct { s *Service parent string diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index 07dccbe6e4c..a5054ab7f5e 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20240930", + "revision": "20241003", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -738,6 +738,10 @@ "description": "Generation config.", "id": "GoogleCloudAiplatformV1beta1GenerationConfig", "properties": { + "audioTimestamp": { + "description": "Optional. If enabled, audio timestamp will be included in the request to the model.", + "type": "boolean" + }, "candidateCount": { "description": "Optional. Number of candidates to generate.", "format": "int32", @@ -1268,7 +1272,7 @@ "type": "string" }, "enum": { - "description": "Optional. Possible values of the element of Type.STRING with enum format. For example we can define an Enum Direction as : {type:STRING, format:enum, enum:[\"EAST\", NORTH\", \"SOUTH\", \"WEST\"]}", + "description": "Optional. Possible values of the element of primitive type with enum format. Examples: 1. We can define direction as : {type:STRING, format:enum, enum:[\"EAST\", NORTH\", \"SOUTH\", \"WEST\"]} 2. We can define apartment number as : {type:INTEGER, format:enum, enum:[\"101\", \"201\", \"301\"]}", "items": { "type": "string" }, diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 38e823618c1..6880dbbaa9f 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -871,6 +871,9 @@ func (s GoogleCloudAiplatformV1beta1GenerateContentResponseUsageMetadata) Marsha // GoogleCloudAiplatformV1beta1GenerationConfig: Generation config. type GoogleCloudAiplatformV1beta1GenerationConfig struct { + // AudioTimestamp: Optional. If enabled, audio timestamp will be included in + // the request to the model. + AudioTimestamp bool `json:"audioTimestamp,omitempty"` // CandidateCount: Optional. Number of candidates to generate. CandidateCount int64 `json:"candidateCount,omitempty"` // FrequencyPenalty: Optional. Frequency penalties. @@ -910,13 +913,13 @@ type GoogleCloudAiplatformV1beta1GenerationConfig struct { TopK float64 `json:"topK,omitempty"` // TopP: Optional. If specified, nucleus sampling will be used. TopP float64 `json:"topP,omitempty"` - // ForceSendFields is a list of field names (e.g. "CandidateCount") to + // ForceSendFields is a list of field names (e.g. "AudioTimestamp") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CandidateCount") to include in + // NullFields is a list of field names (e.g. "AudioTimestamp") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -1554,9 +1557,10 @@ type GoogleCloudAiplatformV1beta1Schema struct { Default interface{} `json:"default,omitempty"` // Description: Optional. The description of the data. Description string `json:"description,omitempty"` - // Enum: Optional. Possible values of the element of Type.STRING with enum - // format. For example we can define an Enum Direction as : {type:STRING, - // format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} + // Enum: Optional. Possible values of the element of primitive type with enum + // format. Examples: 1. We can define direction as : {type:STRING, format:enum, + // enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. We can define apartment number as + // : {type:INTEGER, format:enum, enum:["101", "201", "301"]} Enum []string `json:"enum,omitempty"` // Example: Optional. Example of the object. Will only populated when the // object is the root. diff --git a/language/v1/language-api.json b/language/v1/language-api.json index af6bc627dc9..24f02722d77 100644 --- a/language/v1/language-api.json +++ b/language/v1/language-api.json @@ -246,7 +246,7 @@ } } }, - "revision": "20240220", + "revision": "20240929", "rootUrl": "https://language.googleapis.com/", "schemas": { "AnalyzeEntitiesRequest": { @@ -756,7 +756,11 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", + "A3_MEGAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1042,6 +1046,10 @@ "", "", "", + "", + "", + "", + "", "" ], "type": "string" @@ -1473,7 +1481,11 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", + "A3_MEGAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1759,6 +1771,10 @@ "", "", "", + "", + "", + "", + "", "" ], "type": "string" @@ -2149,7 +2165,11 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", + "A3_MEGAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -2435,6 +2455,10 @@ "", "", "", + "", + "", + "", + "", "" ], "type": "string" @@ -3616,6 +3640,7 @@ "NVIDIA_A100_80GB", "NVIDIA_L4", "NVIDIA_H100_80GB", + "NVIDIA_H100_MEGA_80GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -3632,6 +3657,7 @@ "Nvidia A100 80GB GPU.", "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", + "Nvidia H100 80Gb GPU.", "TPU v2 (JellyFish).", "TPU v3 (DragonFish).", "TPU_v4 (PufferFish).", diff --git a/language/v1/language-gen.go b/language/v1/language-gen.go index 54235e22bb6..8305ee64bb4 100644 --- a/language/v1/language-gen.go +++ b/language/v1/language-gen.go @@ -884,7 +884,11 @@ type CpuMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" + // "A3_MEGAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1398,7 +1402,11 @@ type GpuMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" + // "A3_MEGAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1828,7 +1836,11 @@ type RamMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" + // "A3_MEGAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -3471,6 +3483,7 @@ type XPSImageModelServingSpecModelThroughputEstimation struct { // "NVIDIA_A100_80GB" - Nvidia A100 80GB GPU. // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. + // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 80Gb GPU. // "TPU_V2" - TPU v2 (JellyFish). // "TPU_V3" - TPU v3 (DragonFish). // "TPU_V4_POD" - TPU_v4 (PufferFish). diff --git a/language/v1beta2/language-api.json b/language/v1beta2/language-api.json index 5b25f75d3dd..a4dcc870c24 100644 --- a/language/v1beta2/language-api.json +++ b/language/v1beta2/language-api.json @@ -246,7 +246,7 @@ } } }, - "revision": "20240220", + "revision": "20240929", "rootUrl": "https://language.googleapis.com/", "schemas": { "AnalyzeEntitiesRequest": { @@ -756,7 +756,11 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", + "A3_MEGAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1042,6 +1046,10 @@ "", "", "", + "", + "", + "", + "", "" ], "type": "string" @@ -1491,7 +1499,11 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", + "A3_MEGAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1777,6 +1789,10 @@ "", "", "", + "", + "", + "", + "", "" ], "type": "string" @@ -2167,7 +2183,11 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", + "A3_MEGAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -2453,6 +2473,10 @@ "", "", "", + "", + "", + "", + "", "" ], "type": "string" @@ -3634,6 +3658,7 @@ "NVIDIA_A100_80GB", "NVIDIA_L4", "NVIDIA_H100_80GB", + "NVIDIA_H100_MEGA_80GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -3650,6 +3675,7 @@ "Nvidia A100 80GB GPU.", "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", + "Nvidia H100 80Gb GPU.", "TPU v2 (JellyFish).", "TPU v3 (DragonFish).", "TPU_v4 (PufferFish).", diff --git a/language/v1beta2/language-gen.go b/language/v1beta2/language-gen.go index a19ca9d1286..ea2fdecfcbc 100644 --- a/language/v1beta2/language-gen.go +++ b/language/v1beta2/language-gen.go @@ -886,7 +886,11 @@ type CpuMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" + // "A3_MEGAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1412,7 +1416,11 @@ type GpuMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" + // "A3_MEGAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1840,7 +1848,11 @@ type RamMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" + // "A3_MEGAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -3483,6 +3495,7 @@ type XPSImageModelServingSpecModelThroughputEstimation struct { // "NVIDIA_A100_80GB" - Nvidia A100 80GB GPU. // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. + // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 80Gb GPU. // "TPU_V2" - TPU v2 (JellyFish). // "TPU_V3" - TPU v3 (DragonFish). // "TPU_V4_POD" - TPU_v4 (PufferFish). diff --git a/language/v2/language-api.json b/language/v2/language-api.json index 9d0f1e14ac7..a7f5f6f331a 100644 --- a/language/v2/language-api.json +++ b/language/v2/language-api.json @@ -208,7 +208,7 @@ } } }, - "revision": "20240713", + "revision": "20240929", "rootUrl": "https://language.googleapis.com/", "schemas": { "AnalyzeEntitiesRequest": { @@ -426,6 +426,11 @@ "name": { "description": "The name of the category representing the document.", "type": "string" + }, + "severity": { + "description": "Optional. The classifier's severity of the category. This is only present when the ModerateTextRequest.ModelVersion is set to MODEL_VERSION_2, and the corresponding category has a severity score.", + "format": "float", + "type": "number" } }, "type": "object" @@ -576,6 +581,9 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", "E2_STANDARD_2", @@ -864,6 +872,9 @@ "", "", "", + "", + "", + "", "" ], "type": "string" @@ -1109,6 +1120,9 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", "E2_STANDARD_2", @@ -1397,6 +1411,9 @@ "", "", "", + "", + "", + "", "" ], "type": "string" @@ -1460,6 +1477,20 @@ "document": { "$ref": "Document", "description": "Required. Input document." + }, + "modelVersion": { + "description": "Optional. The model version to use for ModerateText.", + "enum": [ + "MODEL_VERSION_UNSPECIFIED", + "MODEL_VERSION_1", + "MODEL_VERSION_2" + ], + "enumDescriptions": [ + "The default model version.", + "Use the v1 model, this model is used by default when not provided. The v1 model only returns probability (confidence) score for each category.", + "Use the v2 model. The v2 model only returns probability (confidence) score for each category, and returns severity score for a subset of the categories." + ], + "type": "string" } }, "type": "object" @@ -1528,6 +1559,9 @@ "A2_ULTRAGPU_2G", "A2_ULTRAGPU_4G", "A2_ULTRAGPU_8G", + "A3_HIGHGPU_1G", + "A3_HIGHGPU_2G", + "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", "E2_STANDARD_2", @@ -1816,6 +1850,9 @@ "", "", "", + "", + "", + "", "" ], "type": "string" diff --git a/language/v2/language-gen.go b/language/v2/language-gen.go index 39519166f6a..949a9f6b686 100644 --- a/language/v2/language-gen.go +++ b/language/v2/language-gen.go @@ -445,6 +445,10 @@ type ClassificationCategory struct { Confidence float64 `json:"confidence,omitempty"` // Name: The name of the category representing the document. Name string `json:"name,omitempty"` + // Severity: Optional. The classifier's severity of the category. This is only + // present when the ModerateTextRequest.ModelVersion is set to MODEL_VERSION_2, + // and the corresponding category has a severity score. + Severity float64 `json:"severity,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -467,6 +471,7 @@ func (s *ClassificationCategory) UnmarshalJSON(data []byte) error { type NoMethod ClassificationCategory var s1 struct { Confidence gensupport.JSONFloat64 `json:"confidence"` + Severity gensupport.JSONFloat64 `json:"severity"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -474,6 +479,7 @@ func (s *ClassificationCategory) UnmarshalJSON(data []byte) error { return err } s.Confidence = float64(s1.Confidence) + s.Severity = float64(s1.Severity) return nil } @@ -695,6 +701,9 @@ type CpuMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" // "E2_STANDARD_2" @@ -1092,6 +1101,9 @@ type GpuMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" // "E2_STANDARD_2" @@ -1278,6 +1290,17 @@ func (s InfraUsage) MarshalJSON() ([]byte, error) { type ModerateTextRequest struct { // Document: Required. Input document. Document *Document `json:"document,omitempty"` + // ModelVersion: Optional. The model version to use for ModerateText. + // + // Possible values: + // "MODEL_VERSION_UNSPECIFIED" - The default model version. + // "MODEL_VERSION_1" - Use the v1 model, this model is used by default when + // not provided. The v1 model only returns probability (confidence) score for + // each category. + // "MODEL_VERSION_2" - Use the v2 model. The v2 model only returns + // probability (confidence) score for each category, and returns severity score + // for a subset of the categories. + ModelVersion string `json:"modelVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "Document") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1369,6 +1392,9 @@ type RamMetric struct { // "A2_ULTRAGPU_2G" // "A2_ULTRAGPU_4G" // "A2_ULTRAGPU_8G" + // "A3_HIGHGPU_1G" + // "A3_HIGHGPU_2G" + // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" // "E2_STANDARD_2" diff --git a/searchads360/v0/searchads360-api.json b/searchads360/v0/searchads360-api.json index a81c1109c11..87bdc0fa931 100644 --- a/searchads360/v0/searchads360-api.json +++ b/searchads360/v0/searchads360-api.json @@ -260,7 +260,7 @@ } } }, - "revision": "20240822", + "revision": "20241002", "rootUrl": "https://searchads360.googleapis.com/", "schemas": { "GoogleAdsSearchads360V0Common__AdScheduleInfo": { @@ -1170,11 +1170,21 @@ "format": "double", "type": "number" }, + "crossDeviceConversionsByConversionDate": { + "description": "The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.", + "format": "double", + "type": "number" + }, "crossDeviceConversionsValue": { "description": "The sum of the value of cross-device conversions.", "format": "double", "type": "number" }, + "crossDeviceConversionsValueByConversionDate": { + "description": "The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.", + "format": "double", + "type": "number" + }, "crossSellCostOfGoodsSoldMicros": { "description": "Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause", "format": "int64", @@ -1200,6 +1210,16 @@ "format": "double", "type": "number" }, + "generalInvalidClickRate": { + "description": "The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details.", + "format": "double", + "type": "number" + }, + "generalInvalidClicks": { + "description": "Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details.", + "format": "int64", + "type": "string" + }, "historicalCreativeQualityScore": { "description": "The creative historical quality score.", "enum": [ @@ -3384,7 +3404,7 @@ "id": "GoogleAdsSearchads360V0Resources_Campaign_SelectiveOptimization", "properties": { "conversionActions": { - "description": "The selected set of conversion actions for optimizing this campaign.", + "description": "The selected set of resource names for conversion actions for optimizing this campaign.", "items": { "type": "string" }, @@ -4020,6 +4040,14 @@ "readOnly": true, "type": "string" }, + "effectiveLabels": { + "description": "Output only. The resource names of effective labels attached to this ad group. An effective label is a label inherited or directly assigned to this ad group.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "endDate": { "description": "Output only. Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14", "readOnly": true, @@ -4761,6 +4789,31 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel": { + "description": "A relationship between an ad group and an effective label. An effective label is a label inherited or directly assigned to this ad group.", + "id": "GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel", + "properties": { + "adGroup": { + "description": "Immutable. The ad group to which the effective label is attached.", + "type": "string" + }, + "label": { + "description": "Immutable. The effective label assigned to the ad group.", + "type": "string" + }, + "ownerCustomerId": { + "description": "Output only. The ID of the Customer which owns the effective label.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "resourceName": { + "description": "Immutable. The resource name of the ad group effective label. Ad group effective label resource names have the form: `customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}`", + "type": "string" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Resources__AdGroupLabel": { "description": "A relationship between an ad group and a label.", "id": "GoogleAdsSearchads360V0Resources__AdGroupLabel", @@ -5651,7 +5704,7 @@ "type": "string" }, "biddingStrategy": { - "description": "Portfolio bidding strategy used by campaign.", + "description": "The resource name of the portfolio bidding strategy used by the campaign.", "type": "string" }, "biddingStrategySystemStatus": { @@ -5765,7 +5818,7 @@ "type": "string" }, "campaignBudget": { - "description": "The budget of the campaign.", + "description": "The resource name of the campaign budget of the campaign.", "type": "string" }, "createTime": { @@ -5782,6 +5835,14 @@ "$ref": "GoogleAdsSearchads360V0Resources_Campaign_DynamicSearchAdsSetting", "description": "The setting for controlling Dynamic Search Ads (DSA)." }, + "effectiveLabels": { + "description": "Output only. The resource names of effective labels attached to this campaign. An effective label is a label inherited or directly assigned to this campaign.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "endDate": { "description": "The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.", "type": "string" @@ -6351,6 +6412,31 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel": { + "description": "Represents a relationship between a campaign and an effective label. An effective label is a label inherited or directly assigned to this campaign.", + "id": "GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel", + "properties": { + "campaign": { + "description": "Immutable. The campaign to which the effective label is attached.", + "type": "string" + }, + "label": { + "description": "Immutable. The effective label assigned to the campaign.", + "type": "string" + }, + "ownerCustomerId": { + "description": "Output only. The ID of the Customer which owns the effective label.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "resourceName": { + "description": "Immutable. Name of the resource. CampaignEffectivelabel resource names have the form: `customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}`", + "type": "string" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Resources__CampaignLabel": { "description": "Represents a relationship between a campaign and a label.", "id": "GoogleAdsSearchads360V0Resources__CampaignLabel", @@ -8339,6 +8425,10 @@ "$ref": "GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel", "description": "The ad group criterion label referenced in the query." }, + "adGroupEffectiveLabel": { + "$ref": "GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel", + "description": "The ad group effective label referenced in the query." + }, "adGroupLabel": { "$ref": "GoogleAdsSearchads360V0Resources__AdGroupLabel", "description": "The ad group label referenced in the query." @@ -8411,6 +8501,10 @@ "$ref": "GoogleAdsSearchads360V0Resources__CampaignCriterion", "description": "The campaign criterion referenced in the query." }, + "campaignEffectiveLabel": { + "$ref": "GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel", + "description": "The campaign effective label referenced in the query." + }, "campaignLabel": { "$ref": "GoogleAdsSearchads360V0Resources__CampaignLabel", "description": "The campaign label referenced in the query." diff --git a/searchads360/v0/searchads360-gen.go b/searchads360/v0/searchads360-gen.go index db0eac98804..42b8ad7ff42 100644 --- a/searchads360/v0/searchads360-gen.go +++ b/searchads360/v0/searchads360-gen.go @@ -1271,9 +1271,17 @@ type GoogleAdsSearchads360V0Common__Metrics struct { // one device, then converts on a different device or browser. Cross-device // conversions are already included in all_conversions. CrossDeviceConversions float64 `json:"crossDeviceConversions,omitempty"` + // CrossDeviceConversionsByConversionDate: The number of cross-device + // conversions by conversion date. Details for the by_conversion_date columns + // are available at https://support.google.com/sa360/answer/9250611. + CrossDeviceConversionsByConversionDate float64 `json:"crossDeviceConversionsByConversionDate,omitempty"` // CrossDeviceConversionsValue: The sum of the value of cross-device // conversions. CrossDeviceConversionsValue float64 `json:"crossDeviceConversionsValue,omitempty"` + // CrossDeviceConversionsValueByConversionDate: The sum of cross-device + // conversions value by conversion date. Details for the by_conversion_date + // columns are available at https://support.google.com/sa360/answer/9250611. + CrossDeviceConversionsValueByConversionDate float64 `json:"crossDeviceConversionsValueByConversionDate,omitempty"` // CrossSellCostOfGoodsSoldMicros: Cross-sell cost of goods sold (COGS) is the // total cost of products sold as a result of advertising a different product. // How it works: You report conversions with cart data for completed purchases @@ -1340,6 +1348,22 @@ type GoogleAdsSearchads360V0Common__Metrics struct { // Ctr: The number of clicks your ad receives (Clicks) divided by the number of // times your ad is shown (Impressions). Ctr float64 `json:"ctr,omitempty"` + // GeneralInvalidClickRate: The percentage of clicks that have been filtered + // out of your total number of clicks (filtered + non-filtered clicks) due to + // being general invalid clicks. These are clicks Google considers illegitimate + // that are detected through routine means of filtration (that is, known + // invalid data-center traffic, bots and spiders or other crawlers, irregular + // patterns, etc). You're not charged for them, and they don't affect your + // account statistics. See the help page at + // https://support.google.com/campaignmanager/answer/6076504 for details. + GeneralInvalidClickRate float64 `json:"generalInvalidClickRate,omitempty"` + // GeneralInvalidClicks: Number of general invalid clicks. These are a subset + // of your invalid clicks that are detected through routine means of filtration + // (such as known invalid data-center traffic, bots and spiders or other + // crawlers, irregular patterns, etc.). You're not charged for them, and they + // don't affect your account statistics. See the help page at + // https://support.google.com/campaignmanager/answer/6076504 for details. + GeneralInvalidClicks int64 `json:"generalInvalidClicks,omitempty,string"` // HistoricalCreativeQualityScore: The creative historical quality score. // // Possible values: @@ -1617,9 +1641,12 @@ func (s *GoogleAdsSearchads360V0Common__Metrics) UnmarshalJSON(data []byte) erro CostPerConversion gensupport.JSONFloat64 `json:"costPerConversion"` CostPerCurrentModelAttributedConversion gensupport.JSONFloat64 `json:"costPerCurrentModelAttributedConversion"` CrossDeviceConversions gensupport.JSONFloat64 `json:"crossDeviceConversions"` + CrossDeviceConversionsByConversionDate gensupport.JSONFloat64 `json:"crossDeviceConversionsByConversionDate"` CrossDeviceConversionsValue gensupport.JSONFloat64 `json:"crossDeviceConversionsValue"` + CrossDeviceConversionsValueByConversionDate gensupport.JSONFloat64 `json:"crossDeviceConversionsValueByConversionDate"` CrossSellUnitsSold gensupport.JSONFloat64 `json:"crossSellUnitsSold"` Ctr gensupport.JSONFloat64 `json:"ctr"` + GeneralInvalidClickRate gensupport.JSONFloat64 `json:"generalInvalidClickRate"` InteractionRate gensupport.JSONFloat64 `json:"interactionRate"` InvalidClickRate gensupport.JSONFloat64 `json:"invalidClickRate"` LeadUnitsSold gensupport.JSONFloat64 `json:"leadUnitsSold"` @@ -1684,9 +1711,12 @@ func (s *GoogleAdsSearchads360V0Common__Metrics) UnmarshalJSON(data []byte) erro s.CostPerConversion = float64(s1.CostPerConversion) s.CostPerCurrentModelAttributedConversion = float64(s1.CostPerCurrentModelAttributedConversion) s.CrossDeviceConversions = float64(s1.CrossDeviceConversions) + s.CrossDeviceConversionsByConversionDate = float64(s1.CrossDeviceConversionsByConversionDate) s.CrossDeviceConversionsValue = float64(s1.CrossDeviceConversionsValue) + s.CrossDeviceConversionsValueByConversionDate = float64(s1.CrossDeviceConversionsValueByConversionDate) s.CrossSellUnitsSold = float64(s1.CrossSellUnitsSold) s.Ctr = float64(s1.Ctr) + s.GeneralInvalidClickRate = float64(s1.GeneralInvalidClickRate) s.InteractionRate = float64(s1.InteractionRate) s.InvalidClickRate = float64(s1.InvalidClickRate) s.LeadUnitsSold = float64(s1.LeadUnitsSold) @@ -3855,8 +3885,8 @@ func (s GoogleAdsSearchads360V0ResourcesCampaignOptimizationGoalSetting) Marshal // campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN // or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType. type GoogleAdsSearchads360V0ResourcesCampaignSelectiveOptimization struct { - // ConversionActions: The selected set of conversion actions for optimizing - // this campaign. + // ConversionActions: The selected set of resource names for conversion actions + // for optimizing this campaign. ConversionActions []string `json:"conversionActions,omitempty"` // ForceSendFields is a list of field names (e.g. "ConversionActions") to // unconditionally include in API requests. By default, fields with empty or @@ -4565,6 +4595,10 @@ type GoogleAdsSearchads360V0Resources__AdGroup struct { // timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" // format. CreationTime string `json:"creationTime,omitempty"` + // EffectiveLabels: Output only. The resource names of effective labels + // attached to this ad group. An effective label is a label inherited or + // directly assigned to this ad group. + EffectiveLabels []string `json:"effectiveLabels,omitempty"` // EndDate: Output only. Date when the ad group ends serving ads. By default, // the ad group ends on the ad group's end date. If this field is set, then the // ad group ends at the end of the specified date in the customer's time zone. @@ -5181,6 +5215,39 @@ func (s GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel: A relationship +// between an ad group and an effective label. An effective label is a label +// inherited or directly assigned to this ad group. +type GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel struct { + // AdGroup: Immutable. The ad group to which the effective label is attached. + AdGroup string `json:"adGroup,omitempty"` + // Label: Immutable. The effective label assigned to the ad group. + Label string `json:"label,omitempty"` + // OwnerCustomerId: Output only. The ID of the Customer which owns the + // effective label. + OwnerCustomerId int64 `json:"ownerCustomerId,omitempty,string"` + // ResourceName: Immutable. The resource name of the ad group effective label. + // Ad group effective label resource names have the form: + // `customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}` + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdGroup") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AdGroup") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Resources__AdGroupLabel: A relationship between an ad // group and a label. type GoogleAdsSearchads360V0Resources__AdGroupLabel struct { @@ -5998,7 +6065,8 @@ type GoogleAdsSearchads360V0Resources__Campaign struct { // "TRAVEL" - Travel campaigns. // "SOCIAL" - Social campaigns. AdvertisingChannelType string `json:"advertisingChannelType,omitempty"` - // BiddingStrategy: Portfolio bidding strategy used by campaign. + // BiddingStrategy: The resource name of the portfolio bidding strategy used by + // the campaign. BiddingStrategy string `json:"biddingStrategy,omitempty"` // BiddingStrategySystemStatus: Output only. The system status of the // campaign's bidding strategy. @@ -6119,7 +6187,7 @@ type GoogleAdsSearchads360V0Resources__Campaign struct { // "TARGET_SPEND" - Target Spend is an automated bid strategy that sets your // bids to help get as many clicks as possible within your budget. BiddingStrategyType string `json:"biddingStrategyType,omitempty"` - // CampaignBudget: The budget of the campaign. + // CampaignBudget: The resource name of the campaign budget of the campaign. CampaignBudget string `json:"campaignBudget,omitempty"` // CreateTime: Output only. The timestamp when this campaign was created. The // timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" @@ -6132,6 +6200,10 @@ type GoogleAdsSearchads360V0Resources__Campaign struct { // DynamicSearchAdsSetting: The setting for controlling Dynamic Search Ads // (DSA). DynamicSearchAdsSetting *GoogleAdsSearchads360V0ResourcesCampaignDynamicSearchAdsSetting `json:"dynamicSearchAdsSetting,omitempty"` + // EffectiveLabels: Output only. The resource names of effective labels + // attached to this campaign. An effective label is a label inherited or + // directly assigned to this campaign. + EffectiveLabels []string `json:"effectiveLabels,omitempty"` // EndDate: The last day of the campaign in serving customer's timezone in // YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the // campaign will run indefinitely. To set an existing campaign to run @@ -6614,6 +6686,39 @@ func (s *GoogleAdsSearchads360V0Resources__CampaignCriterion) UnmarshalJSON(data return nil } +// GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel: Represents a +// relationship between a campaign and an effective label. An effective label +// is a label inherited or directly assigned to this campaign. +type GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel struct { + // Campaign: Immutable. The campaign to which the effective label is attached. + Campaign string `json:"campaign,omitempty"` + // Label: Immutable. The effective label assigned to the campaign. + Label string `json:"label,omitempty"` + // OwnerCustomerId: Output only. The ID of the Customer which owns the + // effective label. + OwnerCustomerId int64 `json:"ownerCustomerId,omitempty,string"` + // ResourceName: Immutable. Name of the resource. CampaignEffectivelabel + // resource names have the form: + // `customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}` + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "Campaign") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Campaign") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Resources__CampaignLabel: Represents a relationship // between a campaign and a label. type GoogleAdsSearchads360V0Resources__CampaignLabel struct { @@ -8507,6 +8612,8 @@ type GoogleAdsSearchads360V0Services__SearchAds360Row struct { AdGroupCriterion *GoogleAdsSearchads360V0Resources__AdGroupCriterion `json:"adGroupCriterion,omitempty"` // AdGroupCriterionLabel: The ad group criterion label referenced in the query. AdGroupCriterionLabel *GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel `json:"adGroupCriterionLabel,omitempty"` + // AdGroupEffectiveLabel: The ad group effective label referenced in the query. + AdGroupEffectiveLabel *GoogleAdsSearchads360V0Resources__AdGroupEffectiveLabel `json:"adGroupEffectiveLabel,omitempty"` // AdGroupLabel: The ad group label referenced in the query. AdGroupLabel *GoogleAdsSearchads360V0Resources__AdGroupLabel `json:"adGroupLabel,omitempty"` // AgeRangeView: The age range view referenced in the query. @@ -8545,6 +8652,9 @@ type GoogleAdsSearchads360V0Services__SearchAds360Row struct { CampaignBudget *GoogleAdsSearchads360V0Resources__CampaignBudget `json:"campaignBudget,omitempty"` // CampaignCriterion: The campaign criterion referenced in the query. CampaignCriterion *GoogleAdsSearchads360V0Resources__CampaignCriterion `json:"campaignCriterion,omitempty"` + // CampaignEffectiveLabel: The campaign effective label referenced in the + // query. + CampaignEffectiveLabel *GoogleAdsSearchads360V0Resources__CampaignEffectiveLabel `json:"campaignEffectiveLabel,omitempty"` // CampaignLabel: The campaign label referenced in the query. CampaignLabel *GoogleAdsSearchads360V0Resources__CampaignLabel `json:"campaignLabel,omitempty"` // CartDataSalesView: The cart data sales view referenced in the query. diff --git a/speech/v1/speech-api.json b/speech/v1/speech-api.json index a9c7f2e1244..9c424642458 100644 --- a/speech/v1/speech-api.json +++ b/speech/v1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20240108", + "revision": "20240926", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { @@ -1044,7 +1044,8 @@ "OGG_OPUS", "SPEEX_WITH_HEADER_BYTE", "MP3", - "WEBM_OPUS" + "WEBM_OPUS", + "ALAW" ], "enumDescriptions": [ "Not specified.", @@ -1056,7 +1057,8 @@ "Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.", "Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Cloud Speech API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000.", "MP3 audio. MP3 encoding is a Beta feature and only available in v1p1beta1. Support all standard MP3 bitrates (which range from 32-320 kbps). When using this encoding, `sample_rate_hertz` has to match the sample rate of the file being used.", - "Opus encoded audio frames in WebM container ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000." + "Opus encoded audio frames in WebM container ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.", + "8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law." ], "type": "string" }, diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index 80b3723e1f3..eec0fbf8536 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -983,6 +983,8 @@ type RecognitionConfig struct { // "WEBM_OPUS" - Opus encoded audio frames in WebM container // ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` // must be one of 8000, 12000, 16000, 24000, or 48000. + // "ALAW" - 8-bit samples that compand 13-bit audio samples using G.711 + // PCMU/a-law. Encoding string `json:"encoding,omitempty"` // LanguageCode: Required. The language of the supplied audio as a BCP-47 // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: diff --git a/speech/v1p1beta1/speech-api.json b/speech/v1p1beta1/speech-api.json index 796b975361c..53db242eb8c 100644 --- a/speech/v1p1beta1/speech-api.json +++ b/speech/v1p1beta1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20240108", + "revision": "20240926", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { @@ -1060,7 +1060,8 @@ "OGG_OPUS", "SPEEX_WITH_HEADER_BYTE", "MP3", - "WEBM_OPUS" + "WEBM_OPUS", + "ALAW" ], "enumDescriptions": [ "Not specified.", @@ -1072,7 +1073,8 @@ "Opus encoded audio frames in Ogg container ([OggOpus](https://wiki.xiph.org/OggOpus)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.", "Although the use of lossy encodings is not recommended, if a very low bitrate encoding is required, `OGG_OPUS` is highly preferred over Speex encoding. The [Speex](https://speex.org/) encoding supported by Cloud Speech API has a header byte in each block, as in MIME type `audio/x-speex-with-header-byte`. It is a variant of the RTP Speex encoding defined in [RFC 5574](https://tools.ietf.org/html/rfc5574). The stream is a sequence of blocks, one block per RTP packet. Each block starts with a byte containing the length of the block, in bytes, followed by one or more frames of Speex data, padded to an integral number of bytes (octets) as specified in RFC 5574. In other words, each RTP header is replaced with a single byte containing the block length. Only Speex wideband is supported. `sample_rate_hertz` must be 16000.", "MP3 audio. MP3 encoding is a Beta feature and only available in v1p1beta1. Support all standard MP3 bitrates (which range from 32-320 kbps). When using this encoding, `sample_rate_hertz` has to match the sample rate of the file being used.", - "Opus encoded audio frames in WebM container ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000." + "Opus encoded audio frames in WebM container ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.", + "8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law." ], "type": "string" }, diff --git a/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go index 500415c2d4d..964e5213ce6 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -996,6 +996,8 @@ type RecognitionConfig struct { // "WEBM_OPUS" - Opus encoded audio frames in WebM container // ([WebM](https://www.webmproject.org/docs/container/)). `sample_rate_hertz` // must be one of 8000, 12000, 16000, 24000, or 48000. + // "ALAW" - 8-bit samples that compand 13-bit audio samples using G.711 + // PCMU/a-law. Encoding string `json:"encoding,omitempty"` // LanguageCode: Required. The language of the supplied audio as a BCP-47 // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Example: diff --git a/storagetransfer/v1/storagetransfer-api.json b/storagetransfer/v1/storagetransfer-api.json index 08aad037912..fddfc9601a7 100644 --- a/storagetransfer/v1/storagetransfer-api.json +++ b/storagetransfer/v1/storagetransfer-api.json @@ -392,7 +392,7 @@ ], "parameters": { "filter": { - "description": "Required. A list of query parameters specified as JSON text in the form of: `{\"projectId\":\"my_project_id\", \"jobNames\":[\"jobid1\",\"jobid2\",...], \"jobStatuses\":[\"status1\",\"status2\",...]}` Since `jobNames` and `jobStatuses` support multiple values, their values must be specified with array notation. `projectId` is required. `jobNames` and `jobStatuses` are optional. The valid values for `jobStatuses` are case-insensitive: ENABLED, DISABLED, and DELETED.", + "description": "Required. A list of query parameters specified as JSON text in the form of: ``` { \"projectId\":\"my_project_id\", \"jobNames\":[\"jobid1\",\"jobid2\",...], \"jobStatuses\":[\"status1\",\"status2\",...], \"dataBackend\":\"QUERY_REPLICATION_CONFIGS\", \"sourceBucket\":\"source-bucket-name\", \"sinkBucket\":\"sink-bucket-name\", } ``` The JSON formatting in the example is for display only; provide the query parameters without spaces or line breaks. * `projectId` is required. * Since `jobNames` and `jobStatuses` support multiple values, their values must be specified with array notation. `jobNames` and `jobStatuses` are optional. Valid values are case-insensitive: * ENABLED * DISABLED * DELETED * Specify `\"dataBackend\":\"QUERY_REPLICATION_CONFIGS\"` to return a list of cross-bucket replication jobs. * Limit the results to jobs from a particular bucket with `sourceBucket` and/or to a particular bucket with `sinkBucket`.", "location": "query", "required": true, "type": "string" @@ -632,7 +632,7 @@ } } }, - "revision": "20240622", + "revision": "20240928", "rootUrl": "https://storagetransfer.googleapis.com/", "schemas": { "AgentPool": { @@ -1368,24 +1368,24 @@ "type": "object" }, "ReplicationSpec": { - "description": "Specifies the configuration for running a replication job.", + "description": "Specifies the configuration for a cross-bucket replication job. Cross-bucket replication copies new or updated objects from a source Cloud Storage bucket to a destination Cloud Storage bucket. Existing objects in the source bucket are not copied by a new cross-bucket replication job.", "id": "ReplicationSpec", "properties": { "gcsDataSink": { "$ref": "GcsData", - "description": "Specifies cloud Storage data sink." + "description": "The Cloud Storage bucket to which to replicate objects." }, "gcsDataSource": { "$ref": "GcsData", - "description": "Specifies cloud Storage data source." + "description": "The Cloud Storage bucket from which to replicate objects." }, "objectConditions": { "$ref": "ObjectConditions", - "description": "Specifies the object conditions to only include objects that satisfy these conditions in the set of data source objects. Object conditions based on objects' \"last modification time\" do not exclude objects in a data sink." + "description": "Object conditions that determine which objects are transferred. For replication jobs, only `include_prefixes` and `exclude_prefixes` are supported." }, "transferOptions": { "$ref": "TransferOptions", - "description": "Specifies the actions to be performed on the object during replication. Delete options are not supported for replication and when specified, the request fails with an INVALID_ARGUMENT error." + "description": "Specifies the metadata options to be applied during replication. Delete options are not supported. If a delete option is specified, the request fails with an INVALID_ARGUMENT error." } }, "type": "object" diff --git a/storagetransfer/v1/storagetransfer-gen.go b/storagetransfer/v1/storagetransfer-gen.go index 075af9b6242..ad5a8053189 100644 --- a/storagetransfer/v1/storagetransfer-gen.go +++ b/storagetransfer/v1/storagetransfer-gen.go @@ -1308,19 +1308,21 @@ func (s PosixFilesystem) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ReplicationSpec: Specifies the configuration for running a replication job. +// ReplicationSpec: Specifies the configuration for a cross-bucket replication +// job. Cross-bucket replication copies new or updated objects from a source +// Cloud Storage bucket to a destination Cloud Storage bucket. Existing objects +// in the source bucket are not copied by a new cross-bucket replication job. type ReplicationSpec struct { - // GcsDataSink: Specifies cloud Storage data sink. + // GcsDataSink: The Cloud Storage bucket to which to replicate objects. GcsDataSink *GcsData `json:"gcsDataSink,omitempty"` - // GcsDataSource: Specifies cloud Storage data source. + // GcsDataSource: The Cloud Storage bucket from which to replicate objects. GcsDataSource *GcsData `json:"gcsDataSource,omitempty"` - // ObjectConditions: Specifies the object conditions to only include objects - // that satisfy these conditions in the set of data source objects. Object - // conditions based on objects' "last modification time" do not exclude objects - // in a data sink. + // ObjectConditions: Object conditions that determine which objects are + // transferred. For replication jobs, only `include_prefixes` and + // `exclude_prefixes` are supported. ObjectConditions *ObjectConditions `json:"objectConditions,omitempty"` - // TransferOptions: Specifies the actions to be performed on the object during - // replication. Delete options are not supported for replication and when + // TransferOptions: Specifies the metadata options to be applied during + // replication. Delete options are not supported. If a delete option is // specified, the request fails with an INVALID_ARGUMENT error. TransferOptions *TransferOptions `json:"transferOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsDataSink") to @@ -2971,12 +2973,19 @@ type TransferJobsListCall struct { // List: Lists transfer jobs. // // - filter: A list of query parameters specified as JSON text in the form of: -// `{"projectId":"my_project_id", "jobNames":["jobid1","jobid2",...], -// "jobStatuses":["status1","status2",...]}` Since `jobNames` and -// `jobStatuses` support multiple values, their values must be specified with -// array notation. `projectId` is required. `jobNames` and `jobStatuses` are -// optional. The valid values for `jobStatuses` are case-insensitive: -// ENABLED, DISABLED, and DELETED. +// ``` { "projectId":"my_project_id", "jobNames":["jobid1","jobid2",...], +// "jobStatuses":["status1","status2",...], +// "dataBackend":"QUERY_REPLICATION_CONFIGS", +// "sourceBucket":"source-bucket-name", "sinkBucket":"sink-bucket-name", } +// ``` The JSON formatting in the example is for display only; provide the +// query parameters without spaces or line breaks. * `projectId` is required. +// - Since `jobNames` and `jobStatuses` support multiple values, their values +// must be specified with array notation. `jobNames` and `jobStatuses` are +// optional. Valid values are case-insensitive: * ENABLED * DISABLED * +// DELETED * Specify "dataBackend":"QUERY_REPLICATION_CONFIGS" to return a +// list of cross-bucket replication jobs. * Limit the results to jobs from a +// particular bucket with `sourceBucket` and/or to a particular bucket with +// `sinkBucket`. func (r *TransferJobsService) List(filter string) *TransferJobsListCall { c := &TransferJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.urlParams_.Set("filter", filter)