From a990614ba53fcc403665d6003643db6bc4d03ce8 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Tue, 26 Nov 2024 07:24:00 -0800 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2888) --- .../v1/accesscontextmanager-api.json | 12 +- .../v1/accesscontextmanager-gen.go | 12 +- .../v1/addressvalidation-api.json | 12 +- addressvalidation/v1/addressvalidation-gen.go | 48 ++-- appengine/v1/appengine-api.json | 21 +- appengine/v1/appengine-gen.go | 30 +++ appengine/v1alpha/appengine-api.json | 21 +- appengine/v1alpha/appengine-gen.go | 30 +++ appengine/v1beta/appengine-api.json | 21 +- appengine/v1beta/appengine-gen.go | 30 +++ .../v1/contactcenterinsights-api.json | 70 ++++- .../v1/contactcenterinsights-gen.go | 245 +++++++++++++++++- content/v2.1/content-api.json | 6 +- content/v2.1/content-gen.go | 5 +- .../v1alpha/firebaseappdistribution-api.json | 3 +- .../accounts_v1beta/merchantapi-api.json | 24 +- .../accounts_v1beta/merchantapi-gen.go | 71 ++--- ml/v1/ml-api.json | 6 +- ml/v1/ml-gen.go | 4 +- pubsublite/v1/pubsublite-api.json | 4 +- pubsublite/v1/pubsublite-gen.go | 2 +- toolresults/v1beta3/toolresults-api.json | 3 +- 22 files changed, 581 insertions(+), 99 deletions(-) diff --git a/accesscontextmanager/v1/accesscontextmanager-api.json b/accesscontextmanager/v1/accesscontextmanager-api.json index 9c9b84e40ab..1ac3b679bdd 100644 --- a/accesscontextmanager/v1/accesscontextmanager-api.json +++ b/accesscontextmanager/v1/accesscontextmanager-api.json @@ -958,7 +958,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "accesscontextmanager.operations.cancel", @@ -1295,7 +1295,7 @@ } } }, - "revision": "20241113", + "revision": "20241119", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1807,6 +1807,10 @@ "egressTo": { "$ref": "EgressTo", "description": "Defines the conditions on the ApiOperation and destination resources that cause this EgressPolicy to apply." + }, + "title": { + "description": "Optional. Human-readable title for the egress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.", + "type": "string" } }, "type": "object" @@ -2003,6 +2007,10 @@ "ingressTo": { "$ref": "IngressTo", "description": "Defines the conditions on the ApiOperation and request destination that cause this IngressPolicy to apply." + }, + "title": { + "description": "Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.", + "type": "string" } }, "type": "object" diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index cdc14395b78..99539a86362 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -1037,6 +1037,11 @@ type EgressPolicy struct { // EgressTo: Defines the conditions on the ApiOperation and destination // resources that cause this EgressPolicy to apply. EgressTo *EgressTo `json:"egressTo,omitempty"` + // Title: Optional. Human-readable title for the egress rule. The title must be + // unique within the perimeter and can not exceed 100 characters. Within the + // access policy, the combined length of all rule titles must not exceed + // 240,000 characters. + Title string `json:"title,omitempty"` // ForceSendFields is a list of field names (e.g. "EgressFrom") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1370,6 +1375,11 @@ type IngressPolicy struct { // IngressTo: Defines the conditions on the ApiOperation and request // destination that cause this IngressPolicy to apply. IngressTo *IngressTo `json:"ingressTo,omitempty"` + // Title: Optional. Human-readable title for the ingress rule. The title must + // be unique within the perimeter and can not exceed 100 characters. Within the + // access policy, the combined length of all rule titles must not exceed + // 240,000 characters. + Title string `json:"title,omitempty"` // ForceSendFields is a list of field names (e.g. "IngressFrom") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -5675,7 +5685,7 @@ type OperationsCancelCall struct { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, the // operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to // `Code.CANCELLED`. // // - name: The name of the operation resource to be cancelled. diff --git a/addressvalidation/v1/addressvalidation-api.json b/addressvalidation/v1/addressvalidation-api.json index 00ed64208d2..c010a9d5a23 100644 --- a/addressvalidation/v1/addressvalidation-api.json +++ b/addressvalidation/v1/addressvalidation-api.json @@ -151,7 +151,7 @@ } } }, - "revision": "20241110", + "revision": "20241120", "rootUrl": "https://addressvalidation.googleapis.com/", "schemas": { "GoogleGeoTypeViewport": { @@ -769,18 +769,18 @@ "type": "object" }, "GoogleTypePostalAddress": { - "description": "Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created via user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478", + "description": "Represents a postal address. For example for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478", "id": "GoogleTypePostalAddress", "properties": { "addressLines": { - "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (e.g. \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (e.g. Japan), address_language is used to make it explicit (e.g. \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).", + "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (For example \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (For example Japan), address_language is used to make it explicit (For example \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).", "items": { "type": "string" }, "type": "array" }, "administrativeArea": { - "description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.", + "description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (For example \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. For example in Switzerland this should be left unpopulated.", "type": "string" }, "languageCode": { @@ -796,7 +796,7 @@ "type": "string" }, "postalCode": { - "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (e.g. state/zip validation in the U.S.A.).", + "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).", "type": "string" }, "recipients": { @@ -816,7 +816,7 @@ "type": "integer" }, "sortingCode": { - "description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (e.g. \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (e.g. Côte d'Ivoire).", + "description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (For example \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (For example Côte d'Ivoire).", "type": "string" }, "sublocality": { diff --git a/addressvalidation/v1/addressvalidation-gen.go b/addressvalidation/v1/addressvalidation-gen.go index 1d038133e28..0b636f26ae7 100644 --- a/addressvalidation/v1/addressvalidation-gen.go +++ b/addressvalidation/v1/addressvalidation-gen.go @@ -1100,42 +1100,43 @@ func (s *GoogleTypeLatLng) UnmarshalJSON(data []byte) error { return nil } -// GoogleTypePostalAddress: Represents a postal address, e.g. for postal +// GoogleTypePostalAddress: Represents a postal address. For example for postal // delivery or payments addresses. Given a postal address, a postal service can // deliver items to a premise, P.O. Box or similar. It is not intended to model // geographical locations (roads, towns, mountains). In typical usage an -// address would be created via user input or from importing existing data, +// address would be created by user input or from importing existing data, // depending on the type of process. Advice on address input / editing: - Use // an internationalization-ready address widget such as // https://github.com/google/libaddressinput) - Users should not be presented // with UI elements for input or editing of fields outside countries where that -// field is used. For more guidance on how to use this schema, please see: +// field is used. For more guidance on how to use this schema, see: // https://support.google.com/business/answer/6397478 type GoogleTypePostalAddress struct { // AddressLines: Unstructured address lines describing the lower levels of an // address. Because values in address_lines do not have type information and - // may sometimes contain multiple values in a single field (e.g. "Austin, TX"), - // it is important that the line order is clear. The order of address lines - // should be "envelope order" for the country/region of the address. In places - // where this can vary (e.g. Japan), address_language is used to make it - // explicit (e.g. "ja" for large-to-small ordering and "ja-Latn" or "en" for - // small-to-large). This way, the most specific line of an address can be - // selected based on the language. The minimum permitted structural - // representation of an address consists of a region_code with all remaining - // information placed in the address_lines. It would be possible to format such - // an address very approximately without geocoding, but no semantic reasoning - // could be made about any of the address components until it was at least - // partially resolved. Creating an address only containing a region_code and - // address_lines, and then geocoding is the recommended way to handle + // may sometimes contain multiple values in a single field (For example + // "Austin, TX"), it is important that the line order is clear. The order of + // address lines should be "envelope order" for the country/region of the + // address. In places where this can vary (For example Japan), address_language + // is used to make it explicit (For example "ja" for large-to-small ordering + // and "ja-Latn" or "en" for small-to-large). This way, the most specific line + // of an address can be selected based on the language. The minimum permitted + // structural representation of an address consists of a region_code with all + // remaining information placed in the address_lines. It would be possible to + // format such an address very approximately without geocoding, but no semantic + // reasoning could be made about any of the address components until it was at + // least partially resolved. Creating an address only containing a region_code + // and address_lines, and then geocoding is the recommended way to handle // completely unstructured addresses (as opposed to guessing which parts of the // address should be localities or administrative areas). AddressLines []string `json:"addressLines,omitempty"` // AdministrativeArea: Optional. Highest administrative subdivision which is // used for postal addresses of a country or region. For example, this can be a // state, a province, an oblast, or a prefecture. Specifically, for Spain this - // is the province and not the autonomous community (e.g. "Barcelona" and not - // "Catalonia"). Many countries don't use an administrative area in postal - // addresses. E.g. in Switzerland this should be left unpopulated. + // is the province and not the autonomous community (For example "Barcelona" + // and not "Catalonia"). Many countries don't use an administrative area in + // postal addresses. For example in Switzerland this should be left + // unpopulated. AdministrativeArea string `json:"administrativeArea,omitempty"` // LanguageCode: Optional. BCP-47 language code of the contents of this address // (if known). This is often the UI language of the input form or is expected @@ -1155,7 +1156,7 @@ type GoogleTypePostalAddress struct { Organization string `json:"organization,omitempty"` // PostalCode: Optional. Postal code of the address. Not all countries use or // require postal codes to be present, but where they are used, they may - // trigger additional validation with other parts of the address (e.g. + // trigger additional validation with other parts of the address (For example // state/zip validation in the U.S.A.). PostalCode string `json:"postalCode,omitempty"` // Recipients: Optional. The recipient at the address. This field may, under @@ -1174,9 +1175,10 @@ type GoogleTypePostalAddress struct { Revision int64 `json:"revision,omitempty"` // SortingCode: Optional. Additional, country-specific, sorting code. This is // not used in most regions. Where it is used, the value is either a string - // like "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a - // number alone, representing the "sector code" (Jamaica), "delivery area - // indicator" (Malawi) or "post office indicator" (e.g. Côte d'Ivoire). + // like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or + // just a number alone, representing the "sector code" (Jamaica), "delivery + // area indicator" (Malawi) or "post office indicator" (For example Côte + // d'Ivoire). SortingCode string `json:"sortingCode,omitempty"` // Sublocality: Optional. Sublocality of the address. For example, this can be // neighborhoods, boroughs, districts. diff --git a/appengine/v1/appengine-api.json b/appengine/v1/appengine-api.json index e1f3dff1215..ab0e8f30057 100644 --- a/appengine/v1/appengine-api.json +++ b/appengine/v1/appengine-api.json @@ -1778,7 +1778,7 @@ } } }, - "revision": "20241007", + "revision": "20241118", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -3617,6 +3617,25 @@ }, "type": "object" }, + "ResourceEvent": { + "description": "The request that is passed to CLH during per-resource events. The request will be sent with update semantics in all cases except for data governance purge events. These events will be sent with delete semantics and the CLH is expected to delete the resource receiving this event.", + "id": "ResourceEvent", + "properties": { + "eventId": { + "description": "The unique ID for this per-resource event. CLHs can use this value to dedup repeated calls. required", + "type": "string" + }, + "name": { + "description": "The name of the resource for which this event is. required", + "type": "string" + }, + "state": { + "$ref": "ContainerState", + "description": "The state of the project that led to this event." + } + }, + "type": "object" + }, "ResourceRecord": { "description": "A DNS resource record.", "id": "ResourceRecord", diff --git a/appengine/v1/appengine-gen.go b/appengine/v1/appengine-gen.go index 515eb6ec586..aef05d5d726 100644 --- a/appengine/v1/appengine-gen.go +++ b/appengine/v1/appengine-gen.go @@ -2735,6 +2735,36 @@ func (s RequestUtilization) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ResourceEvent: The request that is passed to CLH during per-resource events. +// The request will be sent with update semantics in all cases except for data +// governance purge events. These events will be sent with delete semantics and +// the CLH is expected to delete the resource receiving this event. +type ResourceEvent struct { + // EventId: The unique ID for this per-resource event. CLHs can use this value + // to dedup repeated calls. required + EventId string `json:"eventId,omitempty"` + // Name: The name of the resource for which this event is. required + Name string `json:"name,omitempty"` + // State: The state of the project that led to this event. + State *ContainerState `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "EventId") 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. "EventId") 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 ResourceEvent) MarshalJSON() ([]byte, error) { + type NoMethod ResourceEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ResourceRecord: A DNS resource record. type ResourceRecord struct { // Name: Relative name of the object affected by this record. Only applicable diff --git a/appengine/v1alpha/appengine-api.json b/appengine/v1alpha/appengine-api.json index ac63e22e42d..fb6d3ba8f92 100644 --- a/appengine/v1alpha/appengine-api.json +++ b/appengine/v1alpha/appengine-api.json @@ -946,7 +946,7 @@ } } }, - "revision": "20240906", + "revision": "20241118", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "AuthorizedCertificate": { @@ -1702,6 +1702,25 @@ }, "type": "object" }, + "ResourceEvent": { + "description": "The request that is passed to CLH during per-resource events. The request will be sent with update semantics in all cases except for data governance purge events. These events will be sent with delete semantics and the CLH is expected to delete the resource receiving this event.", + "id": "ResourceEvent", + "properties": { + "eventId": { + "description": "The unique ID for this per-resource event. CLHs can use this value to dedup repeated calls. required", + "type": "string" + }, + "name": { + "description": "The name of the resource for which this event is. required", + "type": "string" + }, + "state": { + "$ref": "ContainerState", + "description": "The state of the project that led to this event." + } + }, + "type": "object" + }, "ResourceRecord": { "description": "A DNS resource record.", "id": "ResourceRecord", diff --git a/appengine/v1alpha/appengine-gen.go b/appengine/v1alpha/appengine-gen.go index bb373e06448..38b90e1c564 100644 --- a/appengine/v1alpha/appengine-gen.go +++ b/appengine/v1alpha/appengine-gen.go @@ -1298,6 +1298,36 @@ func (s Reasons) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ResourceEvent: The request that is passed to CLH during per-resource events. +// The request will be sent with update semantics in all cases except for data +// governance purge events. These events will be sent with delete semantics and +// the CLH is expected to delete the resource receiving this event. +type ResourceEvent struct { + // EventId: The unique ID for this per-resource event. CLHs can use this value + // to dedup repeated calls. required + EventId string `json:"eventId,omitempty"` + // Name: The name of the resource for which this event is. required + Name string `json:"name,omitempty"` + // State: The state of the project that led to this event. + State *ContainerState `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "EventId") 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. "EventId") 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 ResourceEvent) MarshalJSON() ([]byte, error) { + type NoMethod ResourceEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ResourceRecord: A DNS resource record. type ResourceRecord struct { // Name: Relative name of the object affected by this record. Only applicable diff --git a/appengine/v1beta/appengine-api.json b/appengine/v1beta/appengine-api.json index cc6374f945b..c0a75bb1a62 100644 --- a/appengine/v1beta/appengine-api.json +++ b/appengine/v1beta/appengine-api.json @@ -1978,7 +1978,7 @@ } } }, - "revision": "20241007", + "revision": "20241118", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -3868,6 +3868,25 @@ }, "type": "object" }, + "ResourceEvent": { + "description": "The request that is passed to CLH during per-resource events. The request will be sent with update semantics in all cases except for data governance purge events. These events will be sent with delete semantics and the CLH is expected to delete the resource receiving this event.", + "id": "ResourceEvent", + "properties": { + "eventId": { + "description": "The unique ID for this per-resource event. CLHs can use this value to dedup repeated calls. required", + "type": "string" + }, + "name": { + "description": "The name of the resource for which this event is. required", + "type": "string" + }, + "state": { + "$ref": "ContainerState", + "description": "The state of the project that led to this event." + } + }, + "type": "object" + }, "ResourceRecord": { "description": "A DNS resource record.", "id": "ResourceRecord", diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index d034e472b9c..b3efb0fb759 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -2827,6 +2827,36 @@ func (s RequestUtilization) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ResourceEvent: The request that is passed to CLH during per-resource events. +// The request will be sent with update semantics in all cases except for data +// governance purge events. These events will be sent with delete semantics and +// the CLH is expected to delete the resource receiving this event. +type ResourceEvent struct { + // EventId: The unique ID for this per-resource event. CLHs can use this value + // to dedup repeated calls. required + EventId string `json:"eventId,omitempty"` + // Name: The name of the resource for which this event is. required + Name string `json:"name,omitempty"` + // State: The state of the project that led to this event. + State *ContainerState `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "EventId") 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. "EventId") 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 ResourceEvent) MarshalJSON() ([]byte, error) { + type NoMethod ResourceEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ResourceRecord: A DNS resource record. type ResourceRecord struct { // Name: Relative name of the object affected by this record. Only applicable diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index a02a6b7cfd2..cd4665040f8 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -472,6 +472,72 @@ } } }, + "authorizedViewSet": { + "resources": { + "authorizedView": { + "methods": { + "calculateStats": { + "description": "Gets conversation statistics.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/authorizedViewSet/{authorizedViewSetId}/authorizedView/{authorizedViewId}:calculateStats", + "httpMethod": "GET", + "id": "contactcenterinsights.projects.locations.authorizedViewSet.authorizedView.calculateStats", + "parameterOrder": [ + "location" + ], + "parameters": { + "filter": { + "description": "A filter to reduce results to a specific subset. This field is useful for getting statistics about conversations with specific properties.", + "location": "query", + "type": "string" + }, + "location": { + "description": "Required. The location of the conversations.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/authorizedViewSet/[^/]+/authorizedView/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+location}:calculateStats", + "response": { + "$ref": "GoogleCloudContactcenterinsightsV1CalculateStatsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "queryMetrics": { + "description": "Query metrics.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/authorizedViewSet/{authorizedViewSetId}/authorizedView/{authorizedViewId}:queryMetrics", + "httpMethod": "POST", + "id": "contactcenterinsights.projects.locations.authorizedViewSet.authorizedView.queryMetrics", + "parameterOrder": [ + "location" + ], + "parameters": { + "location": { + "description": "Required. The location of the data. \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/authorizedViewSet/[^/]+/authorizedView/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+location}:queryMetrics", + "request": { + "$ref": "GoogleCloudContactcenterinsightsV1QueryMetricsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "conversations": { "methods": { "bulkAnalyze": { @@ -1563,7 +1629,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "contactcenterinsights.projects.locations.operations.cancel", @@ -2509,7 +2575,7 @@ } } }, - "revision": "20241114", + "revision": "20241119", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index 41d83028ca9..756b11427ac 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -169,6 +169,7 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} rs.AnalysisRules = NewProjectsLocationsAnalysisRulesService(s) + rs.AuthorizedViewSet = NewProjectsLocationsAuthorizedViewSetService(s) rs.Conversations = NewProjectsLocationsConversationsService(s) rs.EncryptionSpec = NewProjectsLocationsEncryptionSpecService(s) rs.Insightsdata = NewProjectsLocationsInsightsdataService(s) @@ -185,6 +186,8 @@ type ProjectsLocationsService struct { AnalysisRules *ProjectsLocationsAnalysisRulesService + AuthorizedViewSet *ProjectsLocationsAuthorizedViewSetService + Conversations *ProjectsLocationsConversationsService EncryptionSpec *ProjectsLocationsEncryptionSpecService @@ -211,6 +214,27 @@ type ProjectsLocationsAnalysisRulesService struct { s *Service } +func NewProjectsLocationsAuthorizedViewSetService(s *Service) *ProjectsLocationsAuthorizedViewSetService { + rs := &ProjectsLocationsAuthorizedViewSetService{s: s} + rs.AuthorizedView = NewProjectsLocationsAuthorizedViewSetAuthorizedViewService(s) + return rs +} + +type ProjectsLocationsAuthorizedViewSetService struct { + s *Service + + AuthorizedView *ProjectsLocationsAuthorizedViewSetAuthorizedViewService +} + +func NewProjectsLocationsAuthorizedViewSetAuthorizedViewService(s *Service) *ProjectsLocationsAuthorizedViewSetAuthorizedViewService { + rs := &ProjectsLocationsAuthorizedViewSetAuthorizedViewService{s: s} + return rs +} + +type ProjectsLocationsAuthorizedViewSetAuthorizedViewService struct { + s *Service +} + func NewProjectsLocationsConversationsService(s *Service) *ProjectsLocationsConversationsService { rs := &ProjectsLocationsConversationsService{s: s} rs.Analyses = NewProjectsLocationsConversationsAnalysesService(s) @@ -10730,6 +10754,225 @@ func (c *ProjectsLocationsAnalysisRulesPatchCall) Do(opts ...googleapi.CallOptio return ret, nil } +type ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall struct { + s *Service + location string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// CalculateStats: Gets conversation statistics. +// +// - location: The location of the conversations. +func (r *ProjectsLocationsAuthorizedViewSetAuthorizedViewService) CalculateStats(location string) *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall { + c := &ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.location = location + return c +} + +// Filter sets the optional parameter "filter": A filter to reduce results to a +// specific subset. This field is useful for getting statistics about +// conversations with specific properties. +func (c *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) Filter(filter string) *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall { + c.urlParams_.Set("filter", filter) + 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) Fields(s ...googleapi.Field) *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall { + 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) IfNoneMatch(entityTag string) *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) Context(ctx context.Context) *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall { + 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) 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/{+location}:calculateStats") + 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{ + "location": c.location, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "contactcenterinsights.projects.locations.authorizedViewSet.authorizedView.calculateStats" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudContactcenterinsightsV1CalculateStatsResponse.ServerResponse.Head +// er 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewCalculateStatsCall) Do(opts ...googleapi.CallOption) (*GoogleCloudContactcenterinsightsV1CalculateStatsResponse, 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 := &GoogleCloudContactcenterinsightsV1CalculateStatsResponse{ + 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 ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall struct { + s *Service + location string + googlecloudcontactcenterinsightsv1querymetricsrequest *GoogleCloudContactcenterinsightsV1QueryMetricsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// QueryMetrics: Query metrics. +// +// - location: The location of the data. +// "projects/{project}/locations/{location}". +func (r *ProjectsLocationsAuthorizedViewSetAuthorizedViewService) QueryMetrics(location string, googlecloudcontactcenterinsightsv1querymetricsrequest *GoogleCloudContactcenterinsightsV1QueryMetricsRequest) *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall { + c := &ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.location = location + c.googlecloudcontactcenterinsightsv1querymetricsrequest = googlecloudcontactcenterinsightsv1querymetricsrequest + 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall) Fields(s ...googleapi.Field) *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall) Context(ctx context.Context) *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall { + 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall) 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.googlecloudcontactcenterinsightsv1querymetricsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+location}:queryMetrics") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "location": c.location, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "contactcenterinsights.projects.locations.authorizedViewSet.authorizedView.queryMetrics" 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 *ProjectsLocationsAuthorizedViewSetAuthorizedViewQueryMetricsCall) 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 ProjectsLocationsConversationsBulkAnalyzeCall struct { s *Service parent string @@ -14638,7 +14881,7 @@ type ProjectsLocationsOperationsCancelCall struct { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, the // operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to // `Code.CANCELLED`. // // - name: The name of the operation resource to be cancelled. diff --git a/content/v2.1/content-api.json b/content/v2.1/content-api.json index 46a828dab56..c3954086c67 100644 --- a/content/v2.1/content-api.json +++ b/content/v2.1/content-api.json @@ -4570,7 +4570,7 @@ } } }, - "revision": "20241119", + "revision": "20241120", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { @@ -13901,11 +13901,11 @@ "id": "TimeZone", "properties": { "id": { - "description": "IANA Time Zone Database time zone, e.g. \"America/New_York\".", + "description": "IANA Time Zone Database time zone. For example \"America/New_York\".", "type": "string" }, "version": { - "description": "Optional. IANA Time Zone Database version number, e.g. \"2019a\".", + "description": "Optional. IANA Time Zone Database version number. For example \"2019a\".", "type": "string" } }, diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index 534636c19f2..76a8543d2d3 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -12343,9 +12343,10 @@ func (s TimePeriod) MarshalJSON() ([]byte, error) { // TimeZone: Represents a time zone from the IANA Time Zone Database // (https://www.iana.org/time-zones). type TimeZone struct { - // Id: IANA Time Zone Database time zone, e.g. "America/New_York". + // Id: IANA Time Zone Database time zone. For example "America/New_York". Id string `json:"id,omitempty"` - // Version: Optional. IANA Time Zone Database version number, e.g. "2019a". + // Version: Optional. IANA Time Zone Database version number. For example + // "2019a". Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Id") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json index d7ae06e9041..0962da59887 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json @@ -776,7 +776,7 @@ } } }, - "revision": "20241120", + "revision": "20241121", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { @@ -908,6 +908,7 @@ "id": "GoogleFirebaseAppdistroV1alphaAiInstructions", "properties": { "appDescription": { + "deprecated": true, "description": "Optional. Describes the app to give the AI some context", "type": "string" }, diff --git a/merchantapi/accounts_v1beta/merchantapi-api.json b/merchantapi/accounts_v1beta/merchantapi-api.json index a4a92231a7d..8ec0d5c8186 100644 --- a/merchantapi/accounts_v1beta/merchantapi-api.json +++ b/merchantapi/accounts_v1beta/merchantapi-api.json @@ -1417,7 +1417,7 @@ } } }, - "revision": "20241119", + "revision": "20241120", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Accepted": { @@ -1714,7 +1714,7 @@ "type": "object" }, "CarrierRate": { - "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?hl=en\u0026ref_topic=12570808\u0026sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.", + "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808\u0026sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.", "id": "CarrierRate", "properties": { "carrier": { @@ -2502,7 +2502,7 @@ "id": "PhoneNumber", "properties": { "e164Number": { - "description": "The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting, e.g.: - correct: \"+15552220123\" - incorrect: \"+1 (555) 222-01234 x123\". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes", + "description": "The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: \"+15552220123\" - incorrect: \"+1 (555) 222-01234 x123\". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes", "type": "string" }, "extension": { @@ -2545,18 +2545,18 @@ "type": "object" }, "PostalAddress": { - "description": "Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created via user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478", + "description": "Represents a postal address. For example for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478", "id": "PostalAddress", "properties": { "addressLines": { - "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (e.g. \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (e.g. Japan), address_language is used to make it explicit (e.g. \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).", + "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (For example \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (For example Japan), address_language is used to make it explicit (For example \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).", "items": { "type": "string" }, "type": "array" }, "administrativeArea": { - "description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.", + "description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (For example \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. For example in Switzerland this should be left unpopulated.", "type": "string" }, "languageCode": { @@ -2572,7 +2572,7 @@ "type": "string" }, "postalCode": { - "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (e.g. state/zip validation in the U.S.A.).", + "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).", "type": "string" }, "recipients": { @@ -2592,7 +2592,7 @@ "type": "integer" }, "sortingCode": { - "description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (e.g. \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (e.g. Côte d'Ivoire).", + "description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (For example \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (For example Côte d'Ivoire).", "type": "string" }, "sublocality": { @@ -3112,11 +3112,11 @@ "type": "object" }, "ShortCode": { - "description": "An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (e.g. \"Text 611 to see how many minutes you have remaining on your plan.\"). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (e.g. US and CA).", + "description": "An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example \"Text 611 to see how many minutes you have remaining on your plan.\"). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA).", "id": "ShortCode", "properties": { "number": { - "description": "Required. The short code digits, without a leading plus ('+') or country calling code, e.g. \"611\".", + "description": "Required. The short code digits, without a leading plus ('+') or country calling code. For example \"611\".", "type": "string" }, "regionCode": { @@ -3281,11 +3281,11 @@ "id": "TimeZone", "properties": { "id": { - "description": "IANA Time Zone Database time zone, e.g. \"America/New_York\".", + "description": "IANA Time Zone Database time zone. For example \"America/New_York\".", "type": "string" }, "version": { - "description": "Optional. IANA Time Zone Database version number, e.g. \"2019a\".", + "description": "Optional. IANA Time Zone Database version number. For example \"2019a\".", "type": "string" } }, diff --git a/merchantapi/accounts_v1beta/merchantapi-gen.go b/merchantapi/accounts_v1beta/merchantapi-gen.go index 526101a538c..6e3b495cc5c 100644 --- a/merchantapi/accounts_v1beta/merchantapi-gen.go +++ b/merchantapi/accounts_v1beta/merchantapi-gen.go @@ -699,7 +699,7 @@ func (s BusinessInfo) MarshalJSON() ([]byte, error) { // CarrierRate: A list of carrier rates that can be referred to by `main_table` // or `single_value`. Supported carrier services are defined in -// https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only. +// https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only. type CarrierRate struct { // Carrier: Required. Carrier service, such as "UPS" or "Fedex". Carrier string `json:"carrier,omitempty"` @@ -1759,7 +1759,7 @@ type PhoneNumber struct { // E164Number: The phone number, represented as a leading plus sign ('+'), // followed by a phone number that uses a relaxed ITU E.164 format consisting // of the country calling code (1 to 3 digits) and the subscriber number, with - // no additional spaces or formatting, e.g.: - correct: "+15552220123" - + // no additional spaces or formatting. For example: - correct: "+15552220123" - // incorrect: "+1 (555) 222-01234 x123". The ITU E.164 format limits the latter // to 12 digits, but in practice not all countries respect that, so we relax // that restriction here. National-only numbers are not allowed. References: - @@ -1829,42 +1829,43 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PostalAddress: Represents a postal address, e.g. for postal delivery or -// payments addresses. Given a postal address, a postal service can deliver +// PostalAddress: Represents a postal address. For example for postal delivery +// or payments addresses. Given a postal address, a postal service can deliver // items to a premise, P.O. Box or similar. It is not intended to model // geographical locations (roads, towns, mountains). In typical usage an -// address would be created via user input or from importing existing data, +// address would be created by user input or from importing existing data, // depending on the type of process. Advice on address input / editing: - Use // an internationalization-ready address widget such as // https://github.com/google/libaddressinput) - Users should not be presented // with UI elements for input or editing of fields outside countries where that -// field is used. For more guidance on how to use this schema, please see: +// field is used. For more guidance on how to use this schema, see: // https://support.google.com/business/answer/6397478 type PostalAddress struct { // AddressLines: Unstructured address lines describing the lower levels of an // address. Because values in address_lines do not have type information and - // may sometimes contain multiple values in a single field (e.g. "Austin, TX"), - // it is important that the line order is clear. The order of address lines - // should be "envelope order" for the country/region of the address. In places - // where this can vary (e.g. Japan), address_language is used to make it - // explicit (e.g. "ja" for large-to-small ordering and "ja-Latn" or "en" for - // small-to-large). This way, the most specific line of an address can be - // selected based on the language. The minimum permitted structural - // representation of an address consists of a region_code with all remaining - // information placed in the address_lines. It would be possible to format such - // an address very approximately without geocoding, but no semantic reasoning - // could be made about any of the address components until it was at least - // partially resolved. Creating an address only containing a region_code and - // address_lines, and then geocoding is the recommended way to handle + // may sometimes contain multiple values in a single field (For example + // "Austin, TX"), it is important that the line order is clear. The order of + // address lines should be "envelope order" for the country/region of the + // address. In places where this can vary (For example Japan), address_language + // is used to make it explicit (For example "ja" for large-to-small ordering + // and "ja-Latn" or "en" for small-to-large). This way, the most specific line + // of an address can be selected based on the language. The minimum permitted + // structural representation of an address consists of a region_code with all + // remaining information placed in the address_lines. It would be possible to + // format such an address very approximately without geocoding, but no semantic + // reasoning could be made about any of the address components until it was at + // least partially resolved. Creating an address only containing a region_code + // and address_lines, and then geocoding is the recommended way to handle // completely unstructured addresses (as opposed to guessing which parts of the // address should be localities or administrative areas). AddressLines []string `json:"addressLines,omitempty"` // AdministrativeArea: Optional. Highest administrative subdivision which is // used for postal addresses of a country or region. For example, this can be a // state, a province, an oblast, or a prefecture. Specifically, for Spain this - // is the province and not the autonomous community (e.g. "Barcelona" and not - // "Catalonia"). Many countries don't use an administrative area in postal - // addresses. E.g. in Switzerland this should be left unpopulated. + // is the province and not the autonomous community (For example "Barcelona" + // and not "Catalonia"). Many countries don't use an administrative area in + // postal addresses. For example in Switzerland this should be left + // unpopulated. AdministrativeArea string `json:"administrativeArea,omitempty"` // LanguageCode: Optional. BCP-47 language code of the contents of this address // (if known). This is often the UI language of the input form or is expected @@ -1884,7 +1885,7 @@ type PostalAddress struct { Organization string `json:"organization,omitempty"` // PostalCode: Optional. Postal code of the address. Not all countries use or // require postal codes to be present, but where they are used, they may - // trigger additional validation with other parts of the address (e.g. + // trigger additional validation with other parts of the address (For example // state/zip validation in the U.S.A.). PostalCode string `json:"postalCode,omitempty"` // Recipients: Optional. The recipient at the address. This field may, under @@ -1903,9 +1904,10 @@ type PostalAddress struct { Revision int64 `json:"revision,omitempty"` // SortingCode: Optional. Additional, country-specific, sorting code. This is // not used in most regions. Where it is used, the value is either a string - // like "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a - // number alone, representing the "sector code" (Jamaica), "delivery area - // indicator" (Malawi) or "post office indicator" (e.g. Côte d'Ivoire). + // like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or + // just a number alone, representing the "sector code" (Jamaica), "delivery + // area indicator" (Malawi) or "post office indicator" (For example Côte + // d'Ivoire). SortingCode string `json:"sortingCode,omitempty"` // Sublocality: Optional. Sublocality of the address. For example, this can be // neighborhoods, boroughs, districts. @@ -2525,14 +2527,14 @@ func (s ShippingSettings) MarshalJSON() ([]byte, error) { // ShortCode: An object representing a short code, which is a phone number that // is typically much shorter than regular phone numbers and can be used to // address messages in MMS and SMS systems, as well as for abbreviated dialing -// (e.g. "Text 611 to see how many minutes you have remaining on your plan."). -// Short codes are restricted to a region and are not internationally dialable, -// which means the same short code can exist in different regions, with -// different usage and pricing, even if those regions share the same country -// calling code (e.g. US and CA). +// (For example "Text 611 to see how many minutes you have remaining on your +// plan."). Short codes are restricted to a region and are not internationally +// dialable, which means the same short code can exist in different regions, +// with different usage and pricing, even if those regions share the same +// country calling code (For example: US and CA). type ShortCode struct { // Number: Required. The short code digits, without a leading plus ('+') or - // country calling code, e.g. "611". + // country calling code. For example "611". Number string `json:"number,omitempty"` // RegionCode: Required. The BCP-47 region code of the location where calls to // this short code can be made, such as "US" and "BB". Reference(s): - @@ -2771,9 +2773,10 @@ func (s TermsOfServiceAgreementState) MarshalJSON() ([]byte, error) { // TimeZone: Represents a time zone from the IANA Time Zone Database // (https://www.iana.org/time-zones). type TimeZone struct { - // Id: IANA Time Zone Database time zone, e.g. "America/New_York". + // Id: IANA Time Zone Database time zone. For example "America/New_York". Id string `json:"id,omitempty"` - // Version: Optional. IANA Time Zone Database version number, e.g. "2019a". + // Version: Optional. IANA Time Zone Database version number. For example + // "2019a". Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Id") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/ml/v1/ml-api.json b/ml/v1/ml-api.json index 165ae2ea6df..8d624c87902 100644 --- a/ml/v1/ml-api.json +++ b/ml/v1/ml-api.json @@ -512,7 +512,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "ml.projects.locations.operations.cancel", @@ -1391,7 +1391,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/projects/{projectsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "ml.projects.operations.cancel", @@ -1486,7 +1486,7 @@ } } }, - "revision": "20240122", + "revision": "20241116", "rootUrl": "https://ml.googleapis.com/", "schemas": { "GoogleApi__HttpBody": { diff --git a/ml/v1/ml-gen.go b/ml/v1/ml-gen.go index 3f2a50b5ab3..5d11b81bb8c 100644 --- a/ml/v1/ml-gen.go +++ b/ml/v1/ml-gen.go @@ -5489,7 +5489,7 @@ type ProjectsLocationsOperationsCancelCall struct { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, the // operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to // `Code.CANCELLED`. // // - name: The name of the operation resource to be cancelled. @@ -8792,7 +8792,7 @@ type ProjectsOperationsCancelCall struct { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, the // operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to // `Code.CANCELLED`. // // - name: The name of the operation resource to be cancelled. diff --git a/pubsublite/v1/pubsublite-api.json b/pubsublite/v1/pubsublite-api.json index 7d1eb5ce834..b1d90edb8c0 100644 --- a/pubsublite/v1/pubsublite-api.json +++ b/pubsublite/v1/pubsublite-api.json @@ -114,7 +114,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/admin/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "pubsublite.admin.projects.locations.operations.cancel", @@ -1040,7 +1040,7 @@ } } }, - "revision": "20230804", + "revision": "20241116", "rootUrl": "https://pubsublite.googleapis.com/", "schemas": { "CancelOperationRequest": { diff --git a/pubsublite/v1/pubsublite-gen.go b/pubsublite/v1/pubsublite-gen.go index 82864e077a9..fcf8be63360 100644 --- a/pubsublite/v1/pubsublite-gen.go +++ b/pubsublite/v1/pubsublite-gen.go @@ -1375,7 +1375,7 @@ type AdminProjectsLocationsOperationsCancelCall struct { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, the // operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to // `Code.CANCELLED`. // // - name: The name of the operation resource to be cancelled. diff --git a/toolresults/v1beta3/toolresults-api.json b/toolresults/v1beta3/toolresults-api.json index 26fecdea7b6..2df7588c0d9 100644 --- a/toolresults/v1beta3/toolresults-api.json +++ b/toolresults/v1beta3/toolresults-api.json @@ -15,6 +15,7 @@ "description": "API to publish and access results from developer tools.", "discoveryVersion": "v1", "documentationLink": "https://firebase.google.com/docs/test-lab/", + "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" @@ -1463,7 +1464,7 @@ } } }, - "revision": "20240321", + "revision": "20241121", "rootUrl": "https://toolresults.googleapis.com/", "schemas": { "ANR": {