From 717fa2070b0700ebe187ecbc656d491140e7555d Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Mon, 11 Nov 2024 08:10:55 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- .../v1/accesscontextmanager-api.json | 59 +-- .../v1/accesscontextmanager-gen.go | 67 +-- assuredworkloads/v1/assuredworkloads-api.json | 62 ++- assuredworkloads/v1/assuredworkloads-gen.go | 10 +- .../v1beta1/assuredworkloads-api.json | 62 ++- .../v1beta1/assuredworkloads-gen.go | 10 +- bigquery/v2/bigquery-api.json | 16 +- bigquery/v2/bigquery-gen.go | 16 +- calendar/v3/calendar-api.json | 25 +- calendar/v3/calendar-gen.go | 41 ++ chat/v1/chat-api.json | 22 +- chat/v1/chat-gen.go | 64 +-- chromemanagement/v1/chromemanagement-api.json | 8 +- chromemanagement/v1/chromemanagement-gen.go | 2 + compute/v0.alpha/compute-api.json | 56 +-- compute/v0.alpha/compute-gen.go | 50 +-- compute/v0.alpha/compute2-gen.go | 18 +- compute/v1/compute-api.json | 66 +-- compute/v1/compute-gen.go | 54 +-- compute/v1/compute2-gen.go | 4 +- dataplex/v1/dataplex-api.json | 17 +- dataplex/v1/dataplex-gen.go | 8 + firebase/v1beta1/firebase-api.json | 66 +-- firebase/v1beta1/firebase-gen.go | 387 ++++++++++-------- searchads360/v0/searchads360-api.json | 103 ++++- searchads360/v0/searchads360-gen.go | 122 ++++++ testing/v1/testing-api.json | 26 +- testing/v1/testing-gen.go | 32 +- 28 files changed, 865 insertions(+), 608 deletions(-) diff --git a/accesscontextmanager/v1/accesscontextmanager-api.json b/accesscontextmanager/v1/accesscontextmanager-api.json index 7eb5a60015..4b6ee8717d 100644 --- a/accesscontextmanager/v1/accesscontextmanager-api.json +++ b/accesscontextmanager/v1/accesscontextmanager-api.json @@ -1295,7 +1295,7 @@ } } }, - "revision": "20241028", + "revision": "20241103", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1384,13 +1384,9 @@ }, "type": "array" }, - "reauthSettings": { - "$ref": "ReauthSettings", - "description": "Optional. Reauth settings applied to user access on a given AccessScope." - }, "sessionSettings": { "$ref": "SessionSettings", - "description": "Optional. Session settings applied to user access on a given AccessScope. Migrated from ReauthSettings" + "description": "Optional. Session settings applied to user access on a given AccessScope." } }, "type": "object" @@ -1909,10 +1905,6 @@ "description": "Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: \"organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N\"", "type": "string" }, - "reauthSettings": { - "$ref": "ReauthSettings", - "description": "Optional. GCSL policy for the group key." - }, "restrictedClientApplications": { "description": "Optional. A list of applications that are subject to this binding's restrictions. If the list is empty, the binding restrictions will universally apply to all applications.", "items": { @@ -1929,7 +1921,7 @@ }, "sessionSettings": { "$ref": "SessionSettings", - "description": "Optional. GCSL policy for the group key. Migrated from ReauthSettings" + "description": "Optional. GCSL policy for the group key." } }, "type": "object" @@ -2295,47 +2287,6 @@ }, "type": "object" }, - "ReauthSettings": { - "description": "Stores settings related to Google Cloud Session Length including session duration, the type of challenge (i.e. method) they should face when their session expires, and other related settings.", - "id": "ReauthSettings", - "properties": { - "maxInactivity": { - "description": "Optional. How long a user is allowed to take between actions before a new access token must be issued. Presently only set for Cloud Apps.", - "format": "google-duration", - "type": "string" - }, - "reauthMethod": { - "description": "Optional. Reauth method when users GCP session is up.", - "enum": [ - "REAUTH_METHOD_UNSPECIFIED", - "LOGIN", - "SECURITY_KEY", - "PASSWORD" - ], - "enumDescriptions": [ - "If method undefined in API, we will use LOGIN by default.", - "The user will prompted to perform regular login. Users who are enrolled for two-step verification and haven't chosen to \"Remember this computer\" will be prompted for their second factor.", - "The user will be prompted to autheticate using their security key. If no security key has been configured, then we will fallback to LOGIN.", - "The user will be prompted for their password." - ], - "type": "string" - }, - "sessionLength": { - "description": "Optional. The session length. Setting this field to zero is equal to disabling. Reauth. Also can set infinite session by flipping the enabled bit to false below. If use_oidc_max_age is true, for OIDC apps, the session length will be the minimum of this field and OIDC max_age param.", - "format": "google-duration", - "type": "string" - }, - "sessionLengthEnabled": { - "description": "Optional. Big red button to turn off GCSL. When false, all fields set above will be disregarded and the session length is basically infinite.", - "type": "boolean" - }, - "useOidcMaxAge": { - "description": "Optional. Only useful for OIDC apps. When false, the OIDC max_age param, if passed in the authentication request will be ignored. When true, the re-auth period will be the minimum of the session_length field and the max_age OIDC param.", - "type": "boolean" - } - }, - "type": "object" - }, "ReplaceAccessLevelsRequest": { "description": "A request to replace all existing Access Levels in an Access Policy with the Access Levels provided. This is done atomically.", "id": "ReplaceAccessLevelsRequest", @@ -2427,6 +2378,10 @@ "description": "Description of the `ServicePerimeter` and its use. Does not affect behavior.", "type": "string" }, + "etag": { + "description": "Optional. An opaque identifier for the current version of the `ServicePerimeter`. Clients should not expect this to be in any specific format. If etag is not provided, the operation will be performed as if a valid etag is provided.", + "type": "string" + }, "name": { "description": "Identifier. Resource name for the `ServicePerimeter`. Format: `accessPolicies/{access_policy}/servicePerimeters/{service_perimeter}`. The `service_perimeter` component must begin with a letter, followed by alphanumeric characters or `_`. After you create a `ServicePerimeter`, you cannot change its `name`.", "type": "string" diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index b5dcaff846..72c5f692ec 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -377,11 +377,8 @@ type AccessSettings struct { // field must have exactly one element. Example: // "accessPolicies/9522/accessLevels/device_trusted" AccessLevels []string `json:"accessLevels,omitempty"` - // ReauthSettings: Optional. Reauth settings applied to user access on a given - // AccessScope. - ReauthSettings *ReauthSettings `json:"reauthSettings,omitempty"` // SessionSettings: Optional. Session settings applied to user access on a - // given AccessScope. Migrated from ReauthSettings + // given AccessScope. SessionSettings *SessionSettings `json:"sessionSettings,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevels") to // unconditionally include in API requests. By default, fields with empty or @@ -1218,8 +1215,6 @@ type GcpUserAccessBinding struct { // Should not be specified by the client during creation. Example: // "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N" Name string `json:"name,omitempty"` - // ReauthSettings: Optional. GCSL policy for the group key. - ReauthSettings *ReauthSettings `json:"reauthSettings,omitempty"` // RestrictedClientApplications: Optional. A list of applications that are // subject to this binding's restrictions. If the list is empty, the binding // restrictions will universally apply to all applications. @@ -1228,8 +1223,7 @@ type GcpUserAccessBinding struct { // this binding's restrictions on a subset of applications. This field cannot // be set if restricted_client_applications is set. ScopedAccessSettings []*ScopedAccessSettings `json:"scopedAccessSettings,omitempty"` - // SessionSettings: Optional. GCSL policy for the group key. Migrated from - // ReauthSettings + // SessionSettings: Optional. GCSL policy for the group key. SessionSettings *SessionSettings `json:"sessionSettings,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1871,58 +1865,6 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ReauthSettings: Stores settings related to Google Cloud Session Length -// including session duration, the type of challenge (i.e. method) they should -// face when their session expires, and other related settings. -type ReauthSettings struct { - // MaxInactivity: Optional. How long a user is allowed to take between actions - // before a new access token must be issued. Presently only set for Cloud Apps. - MaxInactivity string `json:"maxInactivity,omitempty"` - // ReauthMethod: Optional. Reauth method when users GCP session is up. - // - // Possible values: - // "REAUTH_METHOD_UNSPECIFIED" - If method undefined in API, we will use - // LOGIN by default. - // "LOGIN" - The user will prompted to perform regular login. Users who are - // enrolled for two-step verification and haven't chosen to "Remember this - // computer" will be prompted for their second factor. - // "SECURITY_KEY" - The user will be prompted to autheticate using their - // security key. If no security key has been configured, then we will fallback - // to LOGIN. - // "PASSWORD" - The user will be prompted for their password. - ReauthMethod string `json:"reauthMethod,omitempty"` - // SessionLength: Optional. The session length. Setting this field to zero is - // equal to disabling. Reauth. Also can set infinite session by flipping the - // enabled bit to false below. If use_oidc_max_age is true, for OIDC apps, the - // session length will be the minimum of this field and OIDC max_age param. - SessionLength string `json:"sessionLength,omitempty"` - // SessionLengthEnabled: Optional. Big red button to turn off GCSL. When false, - // all fields set above will be disregarded and the session length is basically - // infinite. - SessionLengthEnabled bool `json:"sessionLengthEnabled,omitempty"` - // UseOidcMaxAge: Optional. Only useful for OIDC apps. When false, the OIDC - // max_age param, if passed in the authentication request will be ignored. When - // true, the re-auth period will be the minimum of the session_length field and - // the max_age OIDC param. - UseOidcMaxAge bool `json:"useOidcMaxAge,omitempty"` - // ForceSendFields is a list of field names (e.g. "MaxInactivity") 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. "MaxInactivity") 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 ReauthSettings) MarshalJSON() ([]byte, error) { - type NoMethod ReauthSettings - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ReplaceAccessLevelsRequest: A request to replace all existing Access Levels // in an Access Policy with the Access Levels provided. This is done // atomically. @@ -2079,6 +2021,11 @@ type ServicePerimeter struct { // Description: Description of the `ServicePerimeter` and its use. Does not // affect behavior. Description string `json:"description,omitempty"` + // Etag: Optional. An opaque identifier for the current version of the + // `ServicePerimeter`. Clients should not expect this to be in any specific + // format. If etag is not provided, the operation will be performed as if a + // valid etag is provided. + Etag string `json:"etag,omitempty"` // Name: Identifier. Resource name for the `ServicePerimeter`. Format: // `accessPolicies/{access_policy}/servicePerimeters/{service_perimeter}`. The // `service_perimeter` component must begin with a letter, followed by diff --git a/assuredworkloads/v1/assuredworkloads-api.json b/assuredworkloads/v1/assuredworkloads-api.json index 2829576794..8fe1d05f96 100644 --- a/assuredworkloads/v1/assuredworkloads-api.json +++ b/assuredworkloads/v1/assuredworkloads-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20241007", + "revision": "20241107", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest": { @@ -702,6 +702,32 @@ "HEALTHCARE_AND_LIFE_SCIENCES_CONTROLS_US_SUPPORT", "IRS_1075" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Unknown compliance regime.", "Information protection as per DoD IL4 requirements.", @@ -709,8 +735,8 @@ "FedRAMP High data protection controls", "FedRAMP Moderate data protection controls", "Assured Workloads For US Regions data protection controls", - "Health Insurance Portability and Accountability Act controls", - "Health Information Trust Alliance controls", + "[DEPRECATED] Health Insurance Portability and Accountability Act controls", + "[DEPRECATED] Health Information Trust Alliance controls", "Assured Workloads For EU Regions and Support controls", "Assured Workloads For Canada Regions and Support controls", "International Traffic in Arms Regulations", @@ -1191,6 +1217,32 @@ "HEALTHCARE_AND_LIFE_SCIENCES_CONTROLS_US_SUPPORT", "IRS_1075" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Unknown compliance regime.", "Information protection as per DoD IL4 requirements.", @@ -1198,8 +1250,8 @@ "FedRAMP High data protection controls", "FedRAMP Moderate data protection controls", "Assured Workloads For US Regions data protection controls", - "Health Insurance Portability and Accountability Act controls", - "Health Information Trust Alliance controls", + "[DEPRECATED] Health Insurance Portability and Accountability Act controls", + "[DEPRECATED] Health Information Trust Alliance controls", "Assured Workloads For EU Regions and Support controls", "Assured Workloads For Canada Regions and Support controls", "International Traffic in Arms Regulations", diff --git a/assuredworkloads/v1/assuredworkloads-gen.go b/assuredworkloads/v1/assuredworkloads-gen.go index 422ba18a0e..89b7abf445 100644 --- a/assuredworkloads/v1/assuredworkloads-gen.go +++ b/assuredworkloads/v1/assuredworkloads-gen.go @@ -330,8 +330,9 @@ type GoogleCloudAssuredworkloadsV1CreateWorkloadOperationMetadata struct { // "FEDRAMP_MODERATE" - FedRAMP Moderate data protection controls // "US_REGIONAL_ACCESS" - Assured Workloads For US Regions data protection // controls - // "HIPAA" - Health Insurance Portability and Accountability Act controls - // "HITRUST" - Health Information Trust Alliance controls + // "HIPAA" - [DEPRECATED] Health Insurance Portability and Accountability Act + // controls + // "HITRUST" - [DEPRECATED] Health Information Trust Alliance controls // "EU_REGIONS_AND_SUPPORT" - Assured Workloads For EU Regions and Support // controls // "CA_REGIONS_AND_SUPPORT" - Assured Workloads For Canada Regions and @@ -870,8 +871,9 @@ type GoogleCloudAssuredworkloadsV1Workload struct { // "FEDRAMP_MODERATE" - FedRAMP Moderate data protection controls // "US_REGIONAL_ACCESS" - Assured Workloads For US Regions data protection // controls - // "HIPAA" - Health Insurance Portability and Accountability Act controls - // "HITRUST" - Health Information Trust Alliance controls + // "HIPAA" - [DEPRECATED] Health Insurance Portability and Accountability Act + // controls + // "HITRUST" - [DEPRECATED] Health Information Trust Alliance controls // "EU_REGIONS_AND_SUPPORT" - Assured Workloads For EU Regions and Support // controls // "CA_REGIONS_AND_SUPPORT" - Assured Workloads For Canada Regions and diff --git a/assuredworkloads/v1beta1/assuredworkloads-api.json b/assuredworkloads/v1beta1/assuredworkloads-api.json index be89dcea34..6ad585c7b4 100644 --- a/assuredworkloads/v1beta1/assuredworkloads-api.json +++ b/assuredworkloads/v1beta1/assuredworkloads-api.json @@ -656,7 +656,7 @@ } } }, - "revision": "20241007", + "revision": "20241107", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest": { @@ -826,6 +826,32 @@ "HEALTHCARE_AND_LIFE_SCIENCES_CONTROLS_US_SUPPORT", "IRS_1075" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Unknown compliance regime.", "Information protection as per DoD IL4 requirements.", @@ -833,8 +859,8 @@ "FedRAMP High data protection controls", "FedRAMP Moderate data protection controls", "Assured Workloads For US Regions data protection controls", - "Health Insurance Portability and Accountability Act controls", - "Health Information Trust Alliance controls", + "[DEPRECATED] Health Insurance Portability and Accountability Act controls", + "[DEPRECATED] Health Information Trust Alliance controls", "Assured Workloads For EU Regions and Support controls", "Assured Workloads For Canada Regions and Support controls", "International Traffic in Arms Regulations", @@ -1434,6 +1460,32 @@ "HEALTHCARE_AND_LIFE_SCIENCES_CONTROLS_US_SUPPORT", "IRS_1075" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Unknown compliance regime.", "Information protection as per DoD IL4 requirements.", @@ -1441,8 +1493,8 @@ "FedRAMP High data protection controls", "FedRAMP Moderate data protection controls", "Assured Workloads For US Regions data protection controls", - "Health Insurance Portability and Accountability Act controls", - "Health Information Trust Alliance controls", + "[DEPRECATED] Health Insurance Portability and Accountability Act controls", + "[DEPRECATED] Health Information Trust Alliance controls", "Assured Workloads For EU Regions and Support controls", "Assured Workloads For Canada Regions and Support controls", "International Traffic in Arms Regulations", diff --git a/assuredworkloads/v1beta1/assuredworkloads-gen.go b/assuredworkloads/v1beta1/assuredworkloads-gen.go index 5dd2c9a38f..e3e80e4c34 100644 --- a/assuredworkloads/v1beta1/assuredworkloads-gen.go +++ b/assuredworkloads/v1beta1/assuredworkloads-gen.go @@ -423,8 +423,9 @@ type GoogleCloudAssuredworkloadsV1beta1CreateWorkloadOperationMetadata struct { // "FEDRAMP_MODERATE" - FedRAMP Moderate data protection controls // "US_REGIONAL_ACCESS" - Assured Workloads For US Regions data protection // controls - // "HIPAA" - Health Insurance Portability and Accountability Act controls - // "HITRUST" - Health Information Trust Alliance controls + // "HIPAA" - [DEPRECATED] Health Insurance Portability and Accountability Act + // controls + // "HITRUST" - [DEPRECATED] Health Information Trust Alliance controls // "EU_REGIONS_AND_SUPPORT" - Assured Workloads For EU Regions and Support // controls // "CA_REGIONS_AND_SUPPORT" - Assured Workloads For Canada Regions and @@ -1121,8 +1122,9 @@ type GoogleCloudAssuredworkloadsV1beta1Workload struct { // "FEDRAMP_MODERATE" - FedRAMP Moderate data protection controls // "US_REGIONAL_ACCESS" - Assured Workloads For US Regions data protection // controls - // "HIPAA" - Health Insurance Portability and Accountability Act controls - // "HITRUST" - Health Information Trust Alliance controls + // "HIPAA" - [DEPRECATED] Health Insurance Portability and Accountability Act + // controls + // "HITRUST" - [DEPRECATED] Health Information Trust Alliance controls // "EU_REGIONS_AND_SUPPORT" - Assured Workloads For EU Regions and Support // controls // "CA_REGIONS_AND_SUPPORT" - Assured Workloads For Canada Regions and diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index aeae21c1a3..6d8c339809 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -2009,7 +2009,7 @@ } } }, - "revision": "20241013", + "revision": "20241027", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -2087,13 +2087,13 @@ "enumDescriptions": [ "Default value.", "The argument is a variable with fully specified type, which can be a struct or an array, but not a table.", - "The argument is any type, including struct or array, but not a table. To be added: FIXED_TABLE, ANY_TABLE" + "The argument is any type, including struct or array, but not a table." ], "type": "string" }, "dataType": { "$ref": "StandardSqlDataType", - "description": "Required unless argument_kind = ANY_TYPE." + "description": "Set if argument_kind == FIXED_TYPE." }, "isAggregate": { "description": "Optional. Whether the argument is an aggregate function parameter. Must be Unset for routine types other than AGGREGATE_FUNCTION. For AGGREGATE_FUNCTION, if set to false, it is equivalent to adding \"NOT AGGREGATE\" clause in DDL; Otherwise, it is equivalent to omitting \"NOT AGGREGATE\" clause in DDL.", @@ -2592,11 +2592,11 @@ "id": "BigLakeConfiguration", "properties": { "connectionId": { - "description": "Required. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection_id can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}\".", + "description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection_id can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}\".", "type": "string" }, "fileFormat": { - "description": "Required. The file format the table data is stored in.", + "description": "Optional. The file format the table data is stored in.", "enum": [ "FILE_FORMAT_UNSPECIFIED", "PARQUET" @@ -2608,11 +2608,11 @@ "type": "string" }, "storageUri": { - "description": "Required. The fully qualified location prefix of the external folder where table data is stored. The '*' wildcard character is not allowed. The URI should be in the format `gs://bucket/path_to_table/`", + "description": "Optional. The fully qualified location prefix of the external folder where table data is stored. The '*' wildcard character is not allowed. The URI should be in the format `gs://bucket/path_to_table/`", "type": "string" }, "tableFormat": { - "description": "Required. The table format the metadata only snapshots are stored in.", + "description": "Optional. The table format the metadata only snapshots are stored in.", "enum": [ "TABLE_FORMAT_UNSPECIFIED", "ICEBERG" @@ -9407,7 +9407,7 @@ "type": "number" }, "contributionMetric": { - "description": "The contribution metric. Applies to contribution analysis models. Allowed formats supported are for summable and summable ratio contribution metrics. These include expressions such as \"SUM(x)\" or \"SUM(x)/SUM(y)\", where x and y are column names from the base table.", + "description": "The contribution metric. Applies to contribution analysis models. Allowed formats supported are for summable and summable ratio contribution metrics. These include expressions such as `SUM(x)` or `SUM(x)/SUM(y)`, where x and y are column names from the base table.", "type": "string" }, "dartNormalizeType": { diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 1fd7426903..b7a9dbf1e2 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -394,9 +394,9 @@ type Argument struct { // "FIXED_TYPE" - The argument is a variable with fully specified type, which // can be a struct or an array, but not a table. // "ANY_TYPE" - The argument is any type, including struct or array, but not - // a table. To be added: FIXED_TABLE, ANY_TABLE + // a table. ArgumentKind string `json:"argumentKind,omitempty"` - // DataType: Required unless argument_kind = ANY_TYPE. + // DataType: Set if argument_kind == FIXED_TYPE. DataType *StandardSqlDataType `json:"dataType,omitempty"` // IsAggregate: Optional. Whether the argument is an aggregate function // parameter. Must be Unset for routine types other than AGGREGATE_FUNCTION. @@ -951,22 +951,22 @@ func (s BiEngineStatistics) MarshalJSON() ([]byte, error) { // BigLakeConfiguration: Configuration for BigLake managed tables. type BigLakeConfiguration struct { - // ConnectionId: Required. The connection specifying the credentials to be used + // ConnectionId: Optional. The connection specifying the credentials to be used // to read and write to external storage, such as Cloud Storage. The // connection_id can have the form `{project}.{location}.{connection_id}` or // `projects/{project}/locations/{location}/connections/{connection_id}". ConnectionId string `json:"connectionId,omitempty"` - // FileFormat: Required. The file format the table data is stored in. + // FileFormat: Optional. The file format the table data is stored in. // // Possible values: // "FILE_FORMAT_UNSPECIFIED" - Default Value. // "PARQUET" - Apache Parquet format. FileFormat string `json:"fileFormat,omitempty"` - // StorageUri: Required. The fully qualified location prefix of the external + // StorageUri: Optional. The fully qualified location prefix of the external // folder where table data is stored. The '*' wildcard character is not // allowed. The URI should be in the format `gs://bucket/path_to_table/` StorageUri string `json:"storageUri,omitempty"` - // TableFormat: Required. The table format the metadata only snapshots are + // TableFormat: Optional. The table format the metadata only snapshots are // stored in. // // Possible values: @@ -9583,8 +9583,8 @@ type TrainingOptions struct { ColsampleBytree float64 `json:"colsampleBytree,omitempty"` // ContributionMetric: The contribution metric. Applies to contribution // analysis models. Allowed formats supported are for summable and summable - // ratio contribution metrics. These include expressions such as "SUM(x)" or - // "SUM(x)/SUM(y)", where x and y are column names from the base table. + // ratio contribution metrics. These include expressions such as `SUM(x)` or + // `SUM(x)/SUM(y)`, where x and y are column names from the base table. ContributionMetric string `json:"contributionMetric,omitempty"` // DartNormalizeType: Type of normalization algorithm for boosted tree models // using dart booster. diff --git a/calendar/v3/calendar-api.json b/calendar/v3/calendar-api.json index 5b4b20d757..c5abdfa984 100644 --- a/calendar/v3/calendar-api.json +++ b/calendar/v3/calendar-api.json @@ -1767,7 +1767,7 @@ } } }, - "revision": "20240927", + "revision": "20241101", "rootUrl": "https://www.googleapis.com/", "schemas": { "Acl": { @@ -2362,6 +2362,10 @@ "description": "Whether attendees may have been omitted from the event's representation. When retrieving an event, this may be due to a restriction specified by the maxAttendee query parameter. When updating an event, this can be used to only update the participant's response. Optional. The default is False.", "type": "boolean" }, + "birthdayProperties": { + "$ref": "EventBirthdayProperties", + "description": "Birthday or special event data. Used if eventType is \"birthday\". Immutable." + }, "colorId": { "description": "The color of the event. This is an ID referring to an entry in the event section of the colors definition (see the colors endpoint). Optional.", "type": "string" @@ -2748,6 +2752,25 @@ }, "type": "object" }, + "EventBirthdayProperties": { + "id": "EventBirthdayProperties", + "properties": { + "contact": { + "description": "Resource name of the contact this birthday event is linked to. This can be used to fetch contact details from People API. Format: \"people/c12345\". Read-only.", + "type": "string" + }, + "customTypeName": { + "description": "Custom type label specified for this event. This is populated if birthdayProperties.type is set to \"custom\". Read-only.", + "type": "string" + }, + "type": { + "default": "birthday", + "description": "Type of birthday or special event. Possible values are: \n- \"anniversary\" - An anniversary other than birthday. Always has a contact. \n- \"birthday\" - A birthday event. This is the default value. \n- \"custom\" - A special date whose label is further specified in the customTypeName field. Always has a contact. \n- \"other\" - A special date which does not fall into the other categories, and does not have a custom label. Always has a contact. \n- \"self\" - Calendar owner's own birthday. Cannot have a contact. The Calendar API only supports creating events with the type \"birthday\". The type cannot be changed after the event is created.", + "type": "string" + } + }, + "type": "object" + }, "EventDateTime": { "id": "EventDateTime", "properties": { diff --git a/calendar/v3/calendar-gen.go b/calendar/v3/calendar-gen.go index 0a9342ed2b..59f2cffa68 100644 --- a/calendar/v3/calendar-gen.go +++ b/calendar/v3/calendar-gen.go @@ -1091,6 +1091,9 @@ type Event struct { // can be used to only update the participant's response. Optional. The default // is False. AttendeesOmitted bool `json:"attendeesOmitted,omitempty"` + // BirthdayProperties: Birthday or special event data. Used if eventType is + // "birthday". Immutable. + BirthdayProperties *EventBirthdayProperties `json:"birthdayProperties,omitempty"` // ColorId: The color of the event. This is an ID referring to an entry in the // event section of the colors definition (see the colors endpoint). Optional. ColorId string `json:"colorId,omitempty"` @@ -1580,6 +1583,44 @@ func (s EventAttendee) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type EventBirthdayProperties struct { + // Contact: Resource name of the contact this birthday event is linked to. This + // can be used to fetch contact details from People API. Format: + // "people/c12345". Read-only. + Contact string `json:"contact,omitempty"` + // CustomTypeName: Custom type label specified for this event. This is + // populated if birthdayProperties.type is set to "custom". Read-only. + CustomTypeName string `json:"customTypeName,omitempty"` + // Type: Type of birthday or special event. Possible values are: + // - "anniversary" - An anniversary other than birthday. Always has a contact. + // + // - "birthday" - A birthday event. This is the default value. + // - "custom" - A special date whose label is further specified in the + // customTypeName field. Always has a contact. + // - "other" - A special date which does not fall into the other categories, + // and does not have a custom label. Always has a contact. + // - "self" - Calendar owner's own birthday. Cannot have a contact. The + // Calendar API only supports creating events with the type "birthday". The + // type cannot be changed after the event is created. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Contact") 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. "Contact") 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 EventBirthdayProperties) MarshalJSON() ([]byte, error) { + type NoMethod EventBirthdayProperties + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type EventDateTime struct { // Date: The date, in the format "yyyy-mm-dd", if this is an all-day event. Date string `json:"date,omitempty"` diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 030e2e3b06..bb1f963d19 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -777,7 +777,7 @@ "type": "string" }, "messageReplyOption": { - "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces.", + "description": "Optional. Specifies whether a message starts a thread or replies to one. Only supported in named spaces. When [responding to user interactions](https://developers.google.com/workspace/chat/receive-respond-interactions), this field is ignored. For interactions within a thread, the reply is created in the same thread. Otherwise, the reply is created as a new thread.", "enum": [ "MESSAGE_REPLY_OPTION_UNSPECIFIED", "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD", @@ -1344,7 +1344,7 @@ } } }, - "revision": "20241103", + "revision": "20241105", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -1556,7 +1556,7 @@ "properties": { "attachmentDataRef": { "$ref": "AttachmentDataRef", - "description": "A reference to the attachment data. This field is used with the media API to download the attachment data." + "description": "Optional. A reference to the attachment data. This field is used to create or update messages with attachments, or with the media API to download the attachment data." }, "contentName": { "description": "Output only. The original file name for the content, not the full path.", @@ -1579,7 +1579,7 @@ "readOnly": true }, "name": { - "description": "Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`.", + "description": "Optional. Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`.", "type": "string" }, "source": { @@ -1610,11 +1610,11 @@ "id": "AttachmentDataRef", "properties": { "attachmentUploadToken": { - "description": "Opaque token containing a reference to an uploaded attachment. Treated by clients as an opaque string and used to create or update Chat messages with attachments.", + "description": "Optional. Opaque token containing a reference to an uploaded attachment. Treated by clients as an opaque string and used to create or update Chat messages with attachments.", "type": "string" }, "resourceName": { - "description": "The resource name of the attachment data. This field is used with the media API to download the attachment data.", + "description": "Optional. The resource name of the attachment data. This field is used with the media API to download the attachment data.", "type": "string" } }, @@ -3070,7 +3070,7 @@ "properties": { "externalDataSource": { "$ref": "GoogleAppsCardV1Action", - "description": "An external data source, such as a relational data base." + "description": "An external data source, such as a relational database." }, "items": { "description": "An array of selectable items. For example, an array of radio buttons or checkboxes. Supports up to 100 items.", @@ -3089,7 +3089,7 @@ "type": "integer" }, "multiSelectMinQueryLength": { - "description": "For multiselect menus, the number of text characters that a user inputs before the app queries autocomplete and displays suggested items in the menu. If unspecified, defaults to 0 characters for static data sources and 3 characters for external data sources.", + "description": "For multiselect menus, the number of text characters that a user inputs before the menu returns suggested selection items. If unset, the multiselect menu uses the following default values: * If the menu uses a static array of `SelectionInput` items, defaults to 0 characters and immediately populates items from the array. * If the menu uses a dynamic data source (`multi_select_data_source`), defaults to 3 characters before querying the data source to return suggested items.", "format": "int32", "type": "integer" }, @@ -3119,7 +3119,7 @@ "A set of radio buttons. Users can select one radio button.", "A set of switches. Users can turn on one or more switches.", "A dropdown menu. Users can select one item from the menu.", - "A multiselect menu for static or dynamic data. From the menu bar, users select one or more items. Users can also input values to populate dynamic data. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To populate items for a multiselect menu, you can use one of the following types of data sources: * Static data: Items are specified as `SelectionItem` objects in the widget. Up to 100 items. * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus, see [Add a multiselect menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):" + "A menu with a text box. Users can type and select one or more items. For Google Workspace Add-ons, you must populate items using a static array of `SelectionItem` objects. For Google Chat apps, you can also populate items using a dynamic data source and autosuggest items as users type in the menu. For example, users can start typing the name of a Google Chat space and the widget autosuggests the space. To dynamically populate items for a multiselect menu, use one of the following types of data sources: * Google Workspace data: Items are populated using data from Google Workspace, such as Google Workspace users or Google Chat spaces. * External data: Items are populated from an external data source outside of Google Workspace. For examples of how to implement multiselect menus for Chat apps, see [Add a multiselect menu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):" ], "type": "string" } @@ -3127,7 +3127,7 @@ "type": "object" }, "GoogleAppsCardV1SelectionItem": { - "description": "An item that users can select in a selection input, such as a checkbox or switch. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "description": "An item that users can select in a selection input, such as a checkbox or switch. Supports up to 100 items. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1SelectionItem", "properties": { "bottomText": { @@ -4906,7 +4906,7 @@ "type": "object" }, "UpdatedWidget": { - "description": "The response of the updated widget. Used to provide autocomplete options for a widget.", + "description": "For `selectionInput` widgets, returns autocomplete suggestions for a multiselect menu.", "id": "UpdatedWidget", "properties": { "suggestions": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 29ad6d42d8..0f13a2be8f 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -723,8 +723,9 @@ func (s AttachedGif) MarshalJSON() ([]byte, error) { // Attachment: An attachment in Google Chat. type Attachment struct { - // AttachmentDataRef: A reference to the attachment data. This field is used - // with the media API to download the attachment data. + // AttachmentDataRef: Optional. A reference to the attachment data. This field + // is used to create or update messages with attachments, or with the media API + // to download the attachment data. AttachmentDataRef *AttachmentDataRef `json:"attachmentDataRef,omitempty"` // ContentName: Output only. The original file name for the content, not the // full path. @@ -738,7 +739,7 @@ type Attachment struct { // DriveDataRef: Output only. A reference to the Google Drive attachment. This // field is used with the Google Drive API. DriveDataRef *DriveDataRef `json:"driveDataRef,omitempty"` - // Name: Resource name of the attachment, in the form + // Name: Optional. Resource name of the attachment, in the form // `spaces/{space}/messages/{message}/attachments/{attachment}`. Name string `json:"name,omitempty"` // Source: Output only. The source of the attachment. @@ -775,12 +776,12 @@ func (s Attachment) MarshalJSON() ([]byte, error) { // AttachmentDataRef: A reference to the attachment data. type AttachmentDataRef struct { - // AttachmentUploadToken: Opaque token containing a reference to an uploaded - // attachment. Treated by clients as an opaque string and used to create or - // update Chat messages with attachments. + // AttachmentUploadToken: Optional. Opaque token containing a reference to an + // uploaded attachment. Treated by clients as an opaque string and used to + // create or update Chat messages with attachments. AttachmentUploadToken string `json:"attachmentUploadToken,omitempty"` - // ResourceName: The resource name of the attachment data. This field is used - // with the media API to download the attachment data. + // ResourceName: Optional. The resource name of the attachment data. This field + // is used with the media API to download the attachment data. ResourceName string `json:"resourceName,omitempty"` // ForceSendFields is a list of field names (e.g. "AttachmentUploadToken") to // unconditionally include in API requests. By default, fields with empty or @@ -3014,7 +3015,7 @@ func (s GoogleAppsCardV1Section) MarshalJSON() ([]byte, error) { // Workspace Add-ons and Chat apps // (https://developers.google.com/workspace/extend): type GoogleAppsCardV1SelectionInput struct { - // ExternalDataSource: An external data source, such as a relational data base. + // ExternalDataSource: An external data source, such as a relational database. ExternalDataSource *GoogleAppsCardV1Action `json:"externalDataSource,omitempty"` // Items: An array of selectable items. For example, an array of radio buttons // or checkboxes. Supports up to 100 items. @@ -3029,10 +3030,12 @@ type GoogleAppsCardV1SelectionInput struct { // defaults to 3 items. MultiSelectMaxSelectedItems int64 `json:"multiSelectMaxSelectedItems,omitempty"` // MultiSelectMinQueryLength: For multiselect menus, the number of text - // characters that a user inputs before the app queries autocomplete and - // displays suggested items in the menu. If unspecified, defaults to 0 - // characters for static data sources and 3 characters for external data - // sources. + // characters that a user inputs before the menu returns suggested selection + // items. If unset, the multiselect menu uses the following default values: * + // If the menu uses a static array of `SelectionInput` items, defaults to 0 + // characters and immediately populates items from the array. * If the menu + // uses a dynamic data source (`multi_select_data_source`), defaults to 3 + // characters before querying the data source to return suggested items. MultiSelectMinQueryLength int64 `json:"multiSelectMinQueryLength,omitempty"` // Name: Required. The name that identifies the selection input in a form input // event. For details about working with form inputs, see Receive form data @@ -3057,17 +3060,18 @@ type GoogleAppsCardV1SelectionInput struct { // button. // "SWITCH" - A set of switches. Users can turn on one or more switches. // "DROPDOWN" - A dropdown menu. Users can select one item from the menu. - // "MULTI_SELECT" - A multiselect menu for static or dynamic data. From the - // menu bar, users select one or more items. Users can also input values to - // populate dynamic data. For example, users can start typing the name of a - // Google Chat space and the widget autosuggests the space. To populate items - // for a multiselect menu, you can use one of the following types of data - // sources: * Static data: Items are specified as `SelectionItem` objects in - // the widget. Up to 100 items. * Google Workspace data: Items are populated - // using data from Google Workspace, such as Google Workspace users or Google - // Chat spaces. * External data: Items are populated from an external data - // source outside of Google Workspace. For examples of how to implement - // multiselect menus, see [Add a multiselect + // "MULTI_SELECT" - A menu with a text box. Users can type and select one or + // more items. For Google Workspace Add-ons, you must populate items using a + // static array of `SelectionItem` objects. For Google Chat apps, you can also + // populate items using a dynamic data source and autosuggest items as users + // type in the menu. For example, users can start typing the name of a Google + // Chat space and the widget autosuggests the space. To dynamically populate + // items for a multiselect menu, use one of the following types of data + // sources: * Google Workspace data: Items are populated using data from Google + // Workspace, such as Google Workspace users or Google Chat spaces. * External + // data: Items are populated from an external data source outside of Google + // Workspace. For examples of how to implement multiselect menus for Chat apps, + // see [Add a multiselect // menu](https://developers.google.com/workspace/chat/design-interactive-card-di // alog#multiselect-menu). [Google Workspace Add-ons and Chat // apps](https://developers.google.com/workspace/extend): @@ -3091,7 +3095,8 @@ func (s GoogleAppsCardV1SelectionInput) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1SelectionItem: An item that users can select in a selection -// input, such as a checkbox or switch. Google Workspace Add-ons and Chat apps +// input, such as a checkbox or switch. Supports up to 100 items. Google +// Workspace Add-ons and Chat apps // (https://developers.google.com/workspace/extend): type GoogleAppsCardV1SelectionItem struct { // BottomText: For multiselect menus, a text description or label that's @@ -5670,8 +5675,8 @@ func (s TimeZone) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// UpdatedWidget: The response of the updated widget. Used to provide -// autocomplete options for a widget. +// UpdatedWidget: For `selectionInput` widgets, returns autocomplete +// suggestions for a multiselect menu. type UpdatedWidget struct { // Suggestions: List of widget autocomplete results Suggestions *SelectionItems `json:"suggestions,omitempty"` @@ -8287,7 +8292,10 @@ func (c *SpacesMessagesCreateCall) MessageId(messageId string) *SpacesMessagesCr // MessageReplyOption sets the optional parameter "messageReplyOption": // Specifies whether a message starts a thread or replies to one. Only -// supported in named spaces. +// supported in named spaces. When responding to user interactions +// (https://developers.google.com/workspace/chat/receive-respond-interactions), +// this field is ignored. For interactions within a thread, the reply is +// created in the same thread. Otherwise, the reply is created as a new thread. // // Possible values: // diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index f14b432f78..567bda02ee 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -1172,7 +1172,7 @@ } } }, - "revision": "20241023", + "revision": "20241107", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -3778,7 +3778,8 @@ "APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR", "APPLICATION_LAUNCH_SOURCE_FOCUS_MODE", "APPLICATION_LAUNCH_SOURCE_SPARKY", - "APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING" + "APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING", + "APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API" ], "enumDescriptions": [ "Application launch source unknown.", @@ -3823,7 +3824,8 @@ "Application launched from welcome tour.", "Applicationed launched from focus panel.", "Application launched from experimental feature Sparky.", - "Application launched from navigation capturing." + "Application launched from navigation capturing.", + "Application launched from web install API." ], "type": "string" }, diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index 651a881e53..6ab6cad8da 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -3089,6 +3089,8 @@ type GoogleChromeManagementV1TelemetryAppLaunchEvent struct { // experimental feature Sparky. // "APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING" - Application launched // from navigation capturing. + // "APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API" - Application launched from + // web install API. AppLaunchSource string `json:"appLaunchSource,omitempty"` // AppType: Type of app. // diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 5160c0bea1..b885c0fea7 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -11621,7 +11621,7 @@ ] }, "addNetworkInterface": { - "description": "Adds one dynamic network interface to an active instance.", + "description": "Adds a network interface to an instance.", "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", "httpMethod": "POST", "id": "compute.instances.addNetworkInterface", @@ -11996,7 +11996,7 @@ ] }, "deleteNetworkInterface": { - "description": "Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network interface to be deleted, using network_interface_name field;", + "description": "Deletes one network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - network interface to be deleted, using network_interface_name field; Only VLAN interface deletion is supported for now.", "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", "httpMethod": "POST", "id": "compute.instances.deleteNetworkInterface", @@ -12014,7 +12014,7 @@ "type": "string" }, "networkInterfaceName": { - "description": "The name of the dynamic network interface to be deleted from the instance.", + "description": "The name of the network interface to be deleted from the instance. Only VLAN network interface deletion is supported.", "location": "query", "required": true, "type": "string" @@ -12438,7 +12438,7 @@ "type": "string" }, "start": { - "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.", + "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", "format": "int64", "location": "query", "type": "string" @@ -47179,7 +47179,7 @@ } } }, - "revision": "20241021", + "revision": "20241105", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -50161,7 +50161,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -51152,7 +51152,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -52944,6 +52944,7 @@ "COMPUTE_OPTIMIZED_H3", "GENERAL_PURPOSE", "GENERAL_PURPOSE_C4", + "GENERAL_PURPOSE_C4A", "GENERAL_PURPOSE_E2", "GENERAL_PURPOSE_N2", "GENERAL_PURPOSE_N2D", @@ -52984,6 +52985,7 @@ "", "", "", + "", "" ], "type": "string" @@ -75595,23 +75597,19 @@ "enum": [ "GVNIC", "IDPF", - "IRDMA", - "MRDMA", "UNSPECIFIED_NIC_TYPE", "VIRTIO_NET" ], "enumDescriptions": [ "GVNIC", "IDPF", - "IRDMA", - "MRDMA", "No type specified.", "VIRTIO" ], "type": "string" }, "parentNicName": { - "description": "Name of the parent network interface of a dynamic network interface.", + "description": "Name of the parent network interface of a VLAN based nic. If this field is specified, vlan must be set.", "type": "string" }, "queueCount": { @@ -75645,7 +75643,7 @@ "type": "string" }, "vlan": { - "description": "VLAN tag of a dynamic network interface, must be in range from 2 to 4094 inclusively.", + "description": "VLAN tag of a VLAN based network interface, must be in range from 2 to 4094 inclusively. This field is mandatory if the parent network interface name is set.", "format": "int32", "type": "integer" } @@ -75966,10 +75964,6 @@ "description": "[Output Only] Type of the resource. Always compute#networkProfile for network profiles.", "type": "string" }, - "location": { - "$ref": "NetworkProfileLocation", - "description": "[Output Only] Location to which the network is restricted." - }, "name": { "description": "[Output Only] Name of the resource.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", @@ -75990,26 +75984,6 @@ }, "type": "object" }, - "NetworkProfileLocation": { - "id": "NetworkProfileLocation", - "properties": { - "name": { - "type": "string" - }, - "scope": { - "enum": [ - "REGION", - "ZONE" - ], - "enumDescriptions": [ - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "NetworkProfileNetworkFeatures": { "id": "NetworkProfileNetworkFeatures", "properties": { @@ -76252,16 +76226,12 @@ "enum": [ "GVNIC", "IDPF", - "IRDMA", - "MRDMA", "UNSPECIFIED_NIC_TYPE", "VIRTIO_NET" ], "enumDescriptions": [ "GVNIC", "IDPF", - "IRDMA", - "MRDMA", "No type specified.", "VIRTIO" ], @@ -97298,7 +97268,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "AGGREGATE", "CLOUD_EXTENSION", @@ -102955,7 +102925,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "AGGREGATE", "CLOUD_EXTENSION", diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index b24bc01574..efadbfd62f 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -5000,8 +5000,7 @@ type BackendBucketCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. If no value - // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + // as well as dynamic content (including HTML), will not be cached. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -6232,8 +6231,7 @@ type BackendServiceCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. If no value - // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + // as well as dynamic content (including HTML), will not be cached. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -8529,6 +8527,7 @@ type Commitment struct { // "COMPUTE_OPTIMIZED_H3" // "GENERAL_PURPOSE" // "GENERAL_PURPOSE_C4" + // "GENERAL_PURPOSE_C4A" // "GENERAL_PURPOSE_E2" // "GENERAL_PURPOSE_N2" // "GENERAL_PURPOSE_N2D" @@ -34322,13 +34321,11 @@ type NetworkInterface struct { // Possible values: // "GVNIC" - GVNIC // "IDPF" - IDPF - // "IRDMA" - IRDMA - // "MRDMA" - MRDMA // "UNSPECIFIED_NIC_TYPE" - No type specified. // "VIRTIO_NET" - VIRTIO NicType string `json:"nicType,omitempty"` - // ParentNicName: Name of the parent network interface of a dynamic network - // interface. + // ParentNicName: Name of the parent network interface of a VLAN based nic. If + // this field is specified, vlan must be set. ParentNicName string `json:"parentNicName,omitempty"` // QueueCount: The networking queue count that's specified by users for the // network interface. Both Rx and Tx queues will be set to this number. It'll @@ -34358,8 +34355,9 @@ type NetworkInterface struct { // https://www.googleapis.com/compute/v1/projects/project/regions/region // /subnetworks/subnetwork - regions/region/subnetworks/subnetwork Subnetwork string `json:"subnetwork,omitempty"` - // Vlan: VLAN tag of a dynamic network interface, must be in range from 2 to - // 4094 inclusively. + // Vlan: VLAN tag of a VLAN based network interface, must be in range from 2 to + // 4094 inclusively. This field is mandatory if the parent network interface + // name is set. Vlan int64 `json:"vlan,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessConfigs") to // unconditionally include in API requests. By default, fields with empty or @@ -34704,8 +34702,6 @@ type NetworkProfile struct { // Kind: [Output Only] Type of the resource. Always compute#networkProfile for // network profiles. Kind string `json:"kind,omitempty"` - // Location: [Output Only] Location to which the network is restricted. - Location *NetworkProfileLocation `json:"location,omitempty"` // Name: [Output Only] Name of the resource. Name string `json:"name,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. @@ -34736,30 +34732,6 @@ func (s NetworkProfile) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type NetworkProfileLocation struct { - Name string `json:"name,omitempty"` - // Possible values: - // "REGION" - // "ZONE" - Scope string `json:"scope,omitempty"` - // ForceSendFields is a list of field names (e.g. "Name") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. 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. "Name") 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 NetworkProfileLocation) MarshalJSON() ([]byte, error) { - type NoMethod NetworkProfileLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type NetworkProfileNetworkFeatures struct { // AddressPurposes: Specifies what address purposes are supported. If empty, // all address purposes are supported. @@ -34901,8 +34873,6 @@ type NetworkProfileNetworkFeatures struct { // Possible values: // "GVNIC" - GVNIC // "IDPF" - IDPF - // "IRDMA" - IRDMA - // "MRDMA" - MRDMA // "UNSPECIFIED_NIC_TYPE" - No type specified. // "VIRTIO_NET" - VIRTIO InterfaceTypes []string `json:"interfaceTypes,omitempty"` @@ -57498,7 +57468,7 @@ type Subnetwork struct { // VMs in this subnet to Google services. PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks @@ -63874,7 +63844,7 @@ type UsableSubnetwork struct { // Network: Network URL. Network string `json:"network,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks diff --git a/compute/v0.alpha/compute2-gen.go b/compute/v0.alpha/compute2-gen.go index 790d9f67b3..e9fa8d4d75 100644 --- a/compute/v0.alpha/compute2-gen.go +++ b/compute/v0.alpha/compute2-gen.go @@ -34543,8 +34543,7 @@ type InstancesAddNetworkInterfaceCall struct { header_ http.Header } -// AddNetworkInterface: Adds one dynamic network interface to an active -// instance. +// AddNetworkInterface: Adds a network interface to an instance. // // - instance: The instance name for this request stored as resource_id. Name // should conform to RFC1035 or be an unsigned long integer. @@ -35532,15 +35531,16 @@ type InstancesDeleteNetworkInterfaceCall struct { header_ http.Header } -// DeleteNetworkInterface: Deletes one dynamic network interface from an active +// DeleteNetworkInterface: Deletes one network interface from an active // instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from -// which to delete, using project+zone+resource_id fields; - dynamic network -// interface to be deleted, using network_interface_name field; +// which to delete, using project+zone+resource_id fields; - network interface +// to be deleted, using network_interface_name field; Only VLAN interface +// deletion is supported for now. // // - instance: The instance name for this request stored as resource_id. Name // should conform to RFC1035 or be an unsigned long integer. -// - networkInterfaceName: The name of the dynamic network interface to be -// deleted from the instance. +// - networkInterfaceName: The name of the network interface to be deleted from +// the instance. Only VLAN network interface deletion is supported. // - project: Project ID for this request. // - zone: The name of the zone for this request. func (r *InstancesService) DeleteNetworkInterface(project string, zone string, instance string, networkInterfaceName string) *InstancesDeleteNetworkInterfaceCall { @@ -36552,9 +36552,7 @@ func (c *InstancesGetSerialPortOutputCall) Port(port int64) *InstancesGetSerialP // adjusted start position is returned as the `start` property value. You can // also provide a negative start position, which translates to the most recent // number of bytes written to the serial port. For example, -3 is interpreted -// as the most recent 3 bytes written to the serial console. Note that the -// negative start is bounded by the retained buffer size, and the returned -// serial console output will not exceed the max buffer size. +// as the most recent 3 bytes written to the serial console. func (c *InstancesGetSerialPortOutputCall) Start(start int64) *InstancesGetSerialPortOutputCall { c.urlParams_.Set("start", fmt.Sprint(start)) return c diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 26136be458..8fe8c383d7 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -10446,7 +10446,7 @@ "type": "string" }, "start": { - "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.", + "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", "format": "int64", "location": "query", "type": "string" @@ -37421,7 +37421,7 @@ } } }, - "revision": "20241021", + "revision": "20241105", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -40146,7 +40146,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -40908,7 +40908,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -42304,6 +42304,7 @@ "COMPUTE_OPTIMIZED_H3", "GENERAL_PURPOSE", "GENERAL_PURPOSE_C4", + "GENERAL_PURPOSE_C4A", "GENERAL_PURPOSE_E2", "GENERAL_PURPOSE_N2", "GENERAL_PURPOSE_N2D", @@ -42335,6 +42336,7 @@ "", "", "", + "", "" ], "type": "string" @@ -60238,34 +60240,6 @@ "description": "A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide.", "id": "NetworkRoutingConfig", "properties": { - "bgpAlwaysCompareMed": { - "description": "Enable comparison of Multi-Exit Discriminators (MED) across routes with different neighbor ASNs when using the STANDARD BGP best path selection algorithm.", - "type": "boolean" - }, - "bgpBestPathSelectionMode": { - "description": "The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD.", - "enum": [ - "LEGACY", - "STANDARD" - ], - "enumDescriptions": [ - "", - "" - ], - "type": "string" - }, - "bgpInterRegionCost": { - "description": "Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED.", - "enum": [ - "ADD_COST_TO_MED", - "DEFAULT" - ], - "enumDescriptions": [ - "", - "" - ], - "type": "string" - }, "routingMode": { "description": "The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions.", "enum": [ @@ -69155,38 +69129,14 @@ "description": "The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/", "type": "string" }, - "nextHopInterRegionCost": { - "description": "[Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions.", - "format": "uint32", - "type": "integer" - }, "nextHopIp": { "description": "The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", "type": "string" }, - "nextHopMed": { - "description": "[Output Only] Multi-Exit Discriminator, a BGP route metric that indicates the desirability of a particular route in a network.", - "format": "uint32", - "type": "integer" - }, "nextHopNetwork": { "description": "The URL of the local network if it should handle matching packets.", "type": "string" }, - "nextHopOrigin": { - "description": "[Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE.", - "enum": [ - "EGP", - "IGP", - "INCOMPLETE" - ], - "enumDescriptions": [ - "", - "", - "" - ], - "type": "string" - }, "nextHopPeering": { "description": "[Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.", "type": "string" @@ -76972,7 +76922,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "GLOBAL_MANAGED_PROXY", "INTERNAL_HTTPS_LOAD_BALANCER", @@ -82167,7 +82117,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "GLOBAL_MANAGED_PROXY", "INTERNAL_HTTPS_LOAD_BALANCER", diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index b7c2191860..b437b422fe 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -4520,8 +4520,7 @@ type BackendBucketCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. If no value - // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + // as well as dynamic content (including HTML), will not be cached. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -5471,8 +5470,7 @@ type BackendServiceCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. If no value - // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. + // as well as dynamic content (including HTML), will not be cached. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -7217,6 +7215,7 @@ type Commitment struct { // "COMPUTE_OPTIMIZED_H3" // "GENERAL_PURPOSE" // "GENERAL_PURPOSE_C4" + // "GENERAL_PURPOSE_C4A" // "GENERAL_PURPOSE_E2" // "GENERAL_PURPOSE_N2" // "GENERAL_PURPOSE_N2D" @@ -27686,26 +27685,6 @@ func (s NetworkPerformanceConfig) MarshalJSON() ([]byte, error) { // network, and a flag indicating the type of routing behavior to enforce // network-wide. type NetworkRoutingConfig struct { - // BgpAlwaysCompareMed: Enable comparison of Multi-Exit Discriminators (MED) - // across routes with different neighbor ASNs when using the STANDARD BGP best - // path selection algorithm. - BgpAlwaysCompareMed bool `json:"bgpAlwaysCompareMed,omitempty"` - // BgpBestPathSelectionMode: The BGP best path selection algorithm to be - // employed within this network for dynamic routes learned by Cloud Routers. - // Can be LEGACY (default) or STANDARD. - // - // Possible values: - // "LEGACY" - // "STANDARD" - BgpBestPathSelectionMode string `json:"bgpBestPathSelectionMode,omitempty"` - // BgpInterRegionCost: Allows to define a preferred approach for handling - // inter-region cost in the selection process when using the STANDARD BGP best - // path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED. - // - // Possible values: - // "ADD_COST_TO_MED" - // "DEFAULT" - BgpInterRegionCost string `json:"bgpInterRegionCost,omitempty"` // RoutingMode: The network-wide routing mode to use. If set to REGIONAL, this // network's Cloud Routers will only advertise routes with subnets of this // network in the same region as the router. If set to GLOBAL, this network's @@ -27716,15 +27695,15 @@ type NetworkRoutingConfig struct { // "GLOBAL" // "REGIONAL" RoutingMode string `json:"routingMode,omitempty"` - // ForceSendFields is a list of field names (e.g. "BgpAlwaysCompareMed") to + // ForceSendFields is a list of field names (e.g. "RoutingMode") 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. "BgpAlwaysCompareMed") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See + // NullFields is a list of field names (e.g. "RoutingMode") 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:"-"` } @@ -37340,10 +37319,6 @@ type Route struct { // You can specify this as a full or partial URL. For example: // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ NextHopInstance string `json:"nextHopInstance,omitempty"` - // NextHopInterRegionCost: [Output only] Internal fixed region-to-region cost - // that Google Cloud calculates based on factors such as network performance, - // distance, and available bandwidth between regions. - NextHopInterRegionCost int64 `json:"nextHopInterRegionCost,omitempty"` // NextHopIp: The network IP address of an instance that should handle matching // packets. Both IPv6 address and IPv4 addresses are supported. Must specify an // IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in @@ -37351,20 +37326,9 @@ type Route struct { // addresses will be displayed using RFC 5952 compressed format (e.g. // 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. NextHopIp string `json:"nextHopIp,omitempty"` - // NextHopMed: [Output Only] Multi-Exit Discriminator, a BGP route metric that - // indicates the desirability of a particular route in a network. - NextHopMed int64 `json:"nextHopMed,omitempty"` // NextHopNetwork: The URL of the local network if it should handle matching // packets. NextHopNetwork string `json:"nextHopNetwork,omitempty"` - // NextHopOrigin: [Output Only] Indicates the origin of the route. Can be IGP - // (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. - // - // Possible values: - // "EGP" - // "IGP" - // "INCOMPLETE" - NextHopOrigin string `json:"nextHopOrigin,omitempty"` // NextHopPeering: [Output Only] The network peering name that should handle // matching packets, which should conform to RFC1035. NextHopPeering string `json:"nextHopPeering,omitempty"` @@ -45658,7 +45622,7 @@ type Subnetwork struct { // VMs in this subnet to Google services. PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks @@ -51498,7 +51462,7 @@ type UsableSubnetwork struct { // Network: Network URL. Network string `json:"network,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks diff --git a/compute/v1/compute2-gen.go b/compute/v1/compute2-gen.go index 6eb7f3b6ff..f66a5b58a3 100644 --- a/compute/v1/compute2-gen.go +++ b/compute/v1/compute2-gen.go @@ -30951,9 +30951,7 @@ func (c *InstancesGetSerialPortOutputCall) Port(port int64) *InstancesGetSerialP // adjusted start position is returned as the `start` property value. You can // also provide a negative start position, which translates to the most recent // number of bytes written to the serial port. For example, -3 is interpreted -// as the most recent 3 bytes written to the serial console. Note that the -// negative start is bounded by the retained buffer size, and the returned -// serial console output will not exceed the max buffer size. +// as the most recent 3 bytes written to the serial console. func (c *InstancesGetSerialPortOutputCall) Start(start int64) *InstancesGetSerialPortOutputCall { c.urlParams_.Set("start", fmt.Sprint(start)) return c diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index faca4745fa..e8ccb7c0b4 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -240,6 +240,16 @@ "description": "Regional Endpoint", "endpointUrl": "https://dataplex.us-west8.rep.googleapis.com/", "location": "us-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us.rep.googleapis.com/", + "location": "us" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.eu.rep.googleapis.com/", + "location": "eu" } ], "fullyEncodeReservedExpansion": true, @@ -6010,6 +6020,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "validateOnly": { + "description": "Optional. The service validates the request without performing any mutations. The default is false.", + "location": "query", + "type": "boolean" } }, "path": "v1/{+parent}/metadataJobs", @@ -6224,7 +6239,7 @@ } } }, - "revision": "20241027", + "revision": "20241106", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index f1862c4552..a5b934a0be 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -28365,6 +28365,14 @@ func (c *ProjectsLocationsMetadataJobsCreateCall) MetadataJobId(metadataJobId st return c } +// ValidateOnly sets the optional parameter "validateOnly": The service +// validates the request without performing any mutations. The default is +// false. +func (c *ProjectsLocationsMetadataJobsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsMetadataJobsCreateCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/firebase/v1beta1/firebase-api.json b/firebase/v1beta1/firebase-api.json index 9520c6f85f..1b14bcf948 100644 --- a/firebase/v1beta1/firebase-api.json +++ b/firebase/v1beta1/firebase-api.json @@ -117,7 +117,7 @@ "availableProjects": { "methods": { "list": { - "description": "Lists each [Google Cloud Platform (GCP) `Project`] (https://cloud.google.com/resource-manager/reference/rest/v1/projects) that can have Firebase resources added to it. A Project will only be listed if: - The caller has sufficient [Google IAM](https://cloud.google.com/iam) permissions to call AddFirebase. - The Project is not already a FirebaseProject. - The Project is not in an Organization which has policies that prevent Firebase resources from being added. ", + "description": "Lists each [Google Cloud `Project`](https://cloud.google.com/resource-manager/reference/rest/v1/projects) that can have Firebase resources added and Firebase services enabled. A Project will only be listed if: - The caller has sufficient [Google IAM](https://cloud.google.com/iam) permissions to call AddFirebase. - The Project is not already a FirebaseProject. - The Project is not in an Organization which has policies that prevent Firebase resources from being added. ", "flatPath": "v1beta1/availableProjects", "httpMethod": "GET", "id": "firebase.availableProjects.list", @@ -183,7 +183,7 @@ "projects": { "methods": { "addFirebase": { - "description": "Adds Firebase resources to the specified existing [Google Cloud Platform (GCP) `Project`] (https://cloud.google.com/resource-manager/reference/rest/v1/projects). Since a FirebaseProject is actually also a GCP `Project`, a `FirebaseProject` has the same underlying GCP identifiers (`projectNumber` and `projectId`). This allows for easy interop with Google APIs. The result of this call is an [`Operation`](../../v1beta1/operations). Poll the `Operation` to track the provisioning process by calling GetOperation until [`done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. When `done` is `true`, the `Operation` has either succeeded or failed. If the `Operation` succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response) is set to a FirebaseProject; if the `Operation` failed, its [`error`](../../v1beta1/operations#Operation.FIELDS.error) is set to a google.rpc.Status. The `Operation` is automatically deleted after completion, so there is no need to call DeleteOperation. This method does not modify any billing account information on the underlying GCP `Project`. To call `AddFirebase`, a project member or service account must have the following permissions (the IAM roles of Editor and Owner contain these permissions): `firebase.projects.update`, `resourcemanager.projects.get`, `serviceusage.services.enable`, and `serviceusage.services.get`.", + "description": "Adds Firebase resources and enables Firebase services in the specified existing [Google Cloud `Project`](https://cloud.google.com/resource-manager/reference/rest/v1/projects). Since a FirebaseProject is actually also a Google Cloud `Project`, a `FirebaseProject` has the same underlying Google Cloud identifiers (`projectNumber` and `projectId`). This allows for easy interop with Google APIs. The result of this call is an [`Operation`](../../v1beta1/operations). Poll the `Operation` to track the provisioning process by calling GetOperation until [`done`](../../v1beta1/operations#Operation.FIELDS.done) is `true`. When `done` is `true`, the `Operation` has either succeeded or failed. If the `Operation` succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response) is set to a FirebaseProject; if the `Operation` failed, its [`error`](../../v1beta1/operations#Operation.FIELDS.error) is set to a google.rpc.Status. The `Operation` is automatically deleted after completion, so there is no need to call DeleteOperation. This method does not modify any billing account information on the underlying Google Cloud `Project`. To call `AddFirebase`, a project member or service account must have the following permissions (the IAM roles of Editor and Owner contain these permissions): `firebase.projects.update`, `resourcemanager.projects.get`, `serviceusage.services.enable`, and `serviceusage.services.get`.", "flatPath": "v1beta1/projects/{projectsId}:addFirebase", "httpMethod": "POST", "id": "firebase.projects.addFirebase", @@ -192,7 +192,7 @@ ], "parameters": { "project": { - "description": "The resource name of the GCP `Project` to which Firebase resources will be added, in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values. After calling `AddFirebase`, the unique Project identifiers ( [`projectNumber`](https://cloud.google.com/resource-manager/reference/rest/v1/projects#Project.FIELDS.project_number) and [`projectId`](https://cloud.google.com/resource-manager/reference/rest/v1/projects#Project.FIELDS.project_id)) of the underlying GCP `Project` are also the identifiers of the FirebaseProject.", + "description": "The resource name of the Google Cloud `Project` in which Firebase resources will be added and Firebase services enabled, in the format: projects/ PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values. After calling `AddFirebase`, the unique Project identifiers ( [`projectNumber`](https://cloud.google.com/resource-manager/reference/rest/v1/projects#Project.FIELDS.project_number) and [`projectId`](https://cloud.google.com/resource-manager/reference/rest/v1/projects#Project.FIELDS.project_id)) of the underlying Google Cloud `Project` are also the identifiers of the FirebaseProject.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -794,7 +794,7 @@ "methods": { "list": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, use the applicable resource-specific REST API (or associated documentation, as needed) to determine valid locations for each resource used in your Project._ Lists the valid Google Cloud Platform (GCP) resource locations for the specified Project (including a FirebaseProject). One of these locations can be selected as the Project's [_default_ GCP resource location](https://firebase.google.com/docs/projects/locations), which is the geographical location where the Project's resources, such as Cloud Firestore, will be provisioned by default. However, if the default GCP resource location has already been set for the Project, then this setting cannot be changed. This call checks for any possible [location restrictions](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) for the specified Project and, thus, might return a subset of all possible GCP resource locations. To list all GCP resource locations (regardless of any restrictions), call the endpoint without specifying a unique project identifier (that is, `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call `ListAvailableLocations` with a specified project, a member must be at minimum a Viewer of the Project. Calls without a specified project do not require any specific project permissions.", + "description": "**DECOMMISSIONED.** **If called, this endpoint will return a 404 error.** _Instead, use the applicable resource-specific REST API (or associated documentation, as needed) to determine valid locations for each resource used in your Project._ Lists the valid [\"locations for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location) for the specified Project (including a FirebaseProject). One of these locations can be selected as the Project's location for default Google Cloud resources, which is the geographical location where the Project's resources associated with Google App Engine (such as the default Cloud Firestore instance) will be provisioned by default. However, if the location for default Google Cloud resources has already been set for the Project, then this setting cannot be changed. This call checks for any possible [location restrictions](https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) for the specified Project and, thus, might return a subset of all possible locations. To list all locations (regardless of any restrictions), call the endpoint without specifying a unique project identifier (that is, `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call `ListAvailableLocations` with a specified project, a member must be at minimum a Viewer of the Project. Calls without a specified project do not require any specific project permissions.", "flatPath": "v1beta1/projects/{projectsId}/availableLocations", "httpMethod": "GET", "id": "firebase.projects.availableLocations.list", @@ -814,7 +814,7 @@ "type": "string" }, "parent": { - "description": "The FirebaseProject for which to list GCP resource locations, in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values. If no unique project identifier is specified (that is, `projects/-`), the returned list does not take into account org-specific or project-specific location restrictions.", + "description": "The FirebaseProject for which to list [locations for default Google Cloud resources](https://firebase.google.com/docs/projects/locations#default-cloud-location), in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values. If no unique project identifier is specified (that is, `projects/-`), the returned list does not take into account org-specific or project-specific location restrictions.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -839,7 +839,7 @@ "methods": { "finalize": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, use the applicable resource-specific REST API to set the location for each resource used in your Project._ Sets the default Google Cloud Platform (GCP) resource location for the specified FirebaseProject. This method creates an App Engine application with a [default Cloud Storage bucket](https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket), located in the specified [`locationId`](#body.request_body.FIELDS.location_id). This location must be one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). After the default GCP resource location is finalized, or if it was already set, it cannot be changed. The default GCP resource location for the specified `FirebaseProject` might already be set because either the underlying GCP `Project` already has an App Engine application or `FinalizeDefaultLocation` was previously called with a specified `locationId`. Any new calls to `FinalizeDefaultLocation` with a *different* specified `locationId` will return a 409 error. The result of this call is an [`Operation`](../../v1beta1/operations), which can be used to track the provisioning process. The [`response`](../../v1beta1/operations#Operation.FIELDS.response) type of the `Operation` is google.protobuf.Empty. The `Operation` can be polled by its `name` using GetOperation until `done` is true. When `done` is true, the `Operation` has either succeeded or failed. If the `Operation` has succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response) will be set to a google.protobuf.Empty; if the `Operation` has failed, its `error` will be set to a google.rpc.Status. The `Operation` is automatically deleted after completion, so there is no need to call DeleteOperation. All fields listed in the [request body](#request-body) are required. To call `FinalizeDefaultLocation`, a member must be an Owner of the Project.", + "description": "**DECOMMISSIONED.** **If called, this endpoint will return a 404 error.** _Instead, use the applicable resource-specific REST API to set the location for each resource used in your Project._ Sets the [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location) for the specified FirebaseProject. This method creates a Google App Engine application with a [default Cloud Storage bucket](https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket), located in the specified [`locationId`](#body.request_body.FIELDS.location_id). This location must be one of the available [App Engine locations](https://cloud.google.com/about/locations#region). After the location for default Google Cloud resources is finalized, or if it was already set, it cannot be changed. The location for default Google Cloud resources for the specified `FirebaseProject` might already be set because either the underlying Google Cloud `Project` already has an App Engine application or `FinalizeDefaultLocation` was previously called with a specified `locationId`. The result of this call is an [`Operation`](../../v1beta1/operations), which can be used to track the provisioning process. The [`response`](../../v1beta1/operations#Operation.FIELDS.response) type of the `Operation` is google.protobuf.Empty. The `Operation` can be polled by its `name` using GetOperation until `done` is true. When `done` is true, the `Operation` has either succeeded or failed. If the `Operation` has succeeded, its [`response`](../../v1beta1/operations#Operation.FIELDS.response) will be set to a google.protobuf.Empty; if the `Operation` has failed, its `error` will be set to a google.rpc.Status. The `Operation` is automatically deleted after completion, so there is no need to call DeleteOperation. All fields listed in the [request body](#request-body) are required. To call `FinalizeDefaultLocation`, a member must be an Owner of the Project.", "flatPath": "v1beta1/projects/{projectsId}/defaultLocation:finalize", "httpMethod": "POST", "id": "firebase.projects.defaultLocation.finalize", @@ -848,7 +848,7 @@ ], "parameters": { "parent": { - "description": "The resource name of the FirebaseProject for which the default GCP resource location will be set, in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values.", + "description": "The resource name of the FirebaseProject for which the [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location) will be set, in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -1324,7 +1324,7 @@ } } }, - "revision": "20241025", + "revision": "20241107", "rootUrl": "https://firebase.googleapis.com/", "schemas": { "AddFirebaseRequest": { @@ -1332,7 +1332,7 @@ "id": "AddFirebaseRequest", "properties": { "locationId": { - "description": "Deprecated. Instead, to set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the GCP `Project`. The ID of the Project's default GCP resource location. The location must be one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations).", + "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to work with the location of each resource in a Project. This field may be ignored, especially for newly provisioned projects after October 30, 2024._ The ID of the Project's [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location), which are resources associated with Google App Engine. The location must be one of the available [Google App Engine locations](https://cloud.google.com/about/locations#region).", "type": "string" } }, @@ -1357,12 +1357,12 @@ "properties": { "databaseURL": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, find the default Firebase Realtime Database instance name using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. Note that the default instance for the Project might not yet be provisioned, so the return might not contain a default instance._ The default Firebase Realtime Database URL.", + "description": "**DEPRECATED.** _Instead, find the URL of the default Realtime Database instance using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. If the default instance for the Project has not yet been provisioned, the return might not contain a default instance. Note that the config that's generated for the Firebase console or the Firebase CLI uses the Realtime Database endpoint to populate this value for that config._ The URL of the default Firebase Realtime Database instance.", "type": "string" }, "locationId": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to find the location of resources._ The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.", + "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to find the location of each resource in a Project. This field may not be populated, especially for newly provisioned projects after October 30, 2024._ The ID of the Project's [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location), which are resources associated with Google App Engine. The location is one of the available [App Engine locations](https://cloud.google.com/about/locations#region). This field is omitted if the location for default Google Cloud resources has not been set.", "type": "string" }, "projectId": { @@ -1371,7 +1371,7 @@ }, "storageBucket": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket name.", + "description": "**DEPRECATED.** _Instead, find the name of the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. If the default bucket for the Project has not yet been provisioned, the return might not contain a default bucket. Note that the config that's generated for the Firebase console or the Firebase CLI uses the Cloud Storage for Firebase endpoint to populate this value for that config._ The name of the default Cloud Storage for Firebase bucket.", "type": "string" } }, @@ -1509,25 +1509,25 @@ "properties": { "hostingSite": { "deprecated": true, - "description": "Output only. **DEPRECATED.** _Instead, find the default Firebase Hosting site name using the [ListSites](https://firebase.google.com/docs/reference/hosting/rest/v1beta1/projects.sites/list) within the Firebase Hosting REST API. Note that the default site for the Project might not yet be provisioned, so the return might not contain a default site._ The default Firebase Hosting site name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Hosting site in another project (learn more about creating non-default, [additional sites](https://firebase.google.com/docs/hosting/multisites)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Hosting site name. For example, if your `projectId` is `myproject123`, your default Hosting site name might be: `myproject123-a5c16`", + "description": "Output only. **DEPRECATED.** _Instead, find the name of the default Firebase Hosting site using [ListSites](https://firebase.google.com/docs/reference/hosting/rest/v1beta1/projects.sites/list) within the Firebase Hosting REST API. If the default Hosting site for the Project has not yet been provisioned, the return might not contain a default site._ The name of the default Firebase Hosting site, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Hosting site in another project (learn more about creating non-default, [additional sites](https://firebase.google.com/docs/hosting/multisites)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Hosting site name. For example, if your `projectId` is `myproject123`, your default Hosting site name might be: `myproject123-a5c16`", "readOnly": true, "type": "string" }, "locationId": { "deprecated": true, - "description": "Output only. **DEPRECATED.** _Instead, use product-specific REST APIs to find the location of resources._ The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.", + "description": "Output only. **DEPRECATED.** _Instead, use product-specific REST APIs to find the location of each resource in a Project. This field may not be populated, especially for newly provisioned projects after October 30, 2024._ The ID of the Project's [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location), which are resources associated with Google App Engine. The location is one of the available [Google App Engine locations](https://cloud.google.com/about/locations#region). This field is omitted if the location for default Google Cloud resources has not been set.", "readOnly": true, "type": "string" }, "realtimeDatabaseInstance": { "deprecated": true, - "description": "Output only. **DEPRECATED.** _Instead, find the default Firebase Realtime Database instance name using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. Note that the default instance for the Project might not yet be provisioned, so the return might not contain a default instance._ The default Firebase Realtime Database instance name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Realtime Database instance in another project (learn more about [database sharding](https://firebase.google.com/docs/database/usage/sharding)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Realtime Database instance name. For example, if your `projectId` is `myproject123`, your default database instance name might be: `myproject123-a5c16`", + "description": "Output only. **DEPRECATED.** _Instead, find the name of the default Realtime Database instance using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. If the default Realtime Database instance for a Project has not yet been provisioned, the return might not contain a default instance._ The default Firebase Realtime Database instance name, in the format: PROJECT_ID Though rare, your `projectId` might already be used as the name for an existing Realtime Database instance in another project (learn more about [database sharding](https://firebase.google.com/docs/database/usage/sharding)). In these cases, your `projectId` is appended with a hyphen then five alphanumeric characters to create your default Realtime Database instance name. For example, if your `projectId` is `myproject123`, your default database instance name might be: `myproject123-a5c16`", "readOnly": true, "type": "string" }, "storageBucket": { "deprecated": true, - "description": "Output only. **DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket, in the format: PROJECT_ID.appspot.com", + "description": "Output only. **DEPRECATED.** _Instead, find the name of the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. If the default bucket for the Project has not yet been provisioned, the return might not contain a default bucket._ The name of the default Cloud Storage for Firebase bucket, in one of the following formats: * If provisioned _before_ October 30, 2024: PROJECT_ID.firebasestorage.app * If provisioned _on or after_ October 30, 2024: PROJECT_ID.firebasestorage.app", "readOnly": true, "type": "string" } @@ -1545,7 +1545,7 @@ "id": "FinalizeDefaultLocationRequest", "properties": { "locationId": { - "description": "The ID of the Project's default GCP resource location. The location must be one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations).", + "description": "**DEPRECATED** The ID of the Project's [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location), which are resources associated with Google App Engine. The location must be one of the available [Google App Engine locations](https://cloud.google.com/about/locations#region).", "type": "string" } }, @@ -1618,7 +1618,7 @@ "type": "object" }, "FirebaseProject": { - "description": "A `FirebaseProject` is the top-level Firebase entity. It is the container for Firebase Apps, Firebase Hosting sites, storage systems (Firebase Realtime Database, Cloud Firestore, Cloud Storage buckets), and other Firebase and Google Cloud Platform (GCP) resources. You create a `FirebaseProject` by calling AddFirebase and specifying an *existing* [GCP `Project`](https://cloud.google.com/resource-manager/reference/rest/v1/projects). This adds Firebase resources to the existing GCP `Project`. Since a FirebaseProject is actually also a GCP `Project`, a `FirebaseProject` has the same underlying GCP identifiers (`projectNumber` and `projectId`). This allows for easy interop with Google APIs.", + "description": "A `FirebaseProject` is the top-level Firebase entity. It is the container for Firebase Apps, Firebase Hosting sites, storage systems (Firebase Realtime Database, Cloud Firestore, Cloud Storage buckets), and other Firebase and Google Cloud resources. You create a `FirebaseProject` by calling AddFirebase and specifying an *existing* [Google Cloud `Project`](https://cloud.google.com/resource-manager/reference/rest/v1/projects). This adds Firebase resources to the existing Google Cloud `Project`. Since a FirebaseProject is actually also a Google Cloud `Project`, a `FirebaseProject` has the same underlying Google Cloud identifiers (`projectNumber` and `projectId`). This allows for easy interop with Google APIs.", "id": "FirebaseProject", "properties": { "annotations": { @@ -1800,7 +1800,7 @@ "type": "string" }, "projectInfo": { - "description": "The list of GCP `Projects` which can have Firebase resources added to them.", + "description": "The list of Google Cloud `Projects` which can have Firebase resources added to them.", "items": { "$ref": "ProjectInfo" }, @@ -1875,11 +1875,11 @@ }, "Location": { "deprecated": true, - "description": "**DEPRECATED.** _This Location is no longer used to determine Firebase resource locations. Instead, consult product documentation to determine valid locations for each resource used in your Project._ A GCP resource location that can be selected for a FirebaseProject.", + "description": "**DEPRECATED.** _This Location is no longer used to determine Firebase resource locations. Instead, consult product documentation to determine valid locations for each resource used in your Project._ A [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location) that can be selected for a FirebaseProject. These are resources associated with Google App Engine.", "id": "Location", "properties": { "features": { - "description": "Products and services that are available in the GCP resource location.", + "description": "Products and services that are available in the location for default Google Cloud resources.", "items": { "enum": [ "LOCATION_FEATURE_UNSPECIFIED", @@ -1889,8 +1889,8 @@ ], "enumDescriptions": [ "Used internally for distinguishing unset values and is not intended for external use.", - "This location supports Cloud Firestore database instances. App Engine is available in this location, so it can be a Project's [default GCP resource location](//firebase.google.com/docs/projects/locations#default-cloud-location).", - "This location supports default Cloud Storage buckets. App Engine is available in this location, so it can be a Project's [default GCP resource location](//firebase.google.com/docs/projects/locations#default-cloud-location).", + "This location supports Cloud Firestore database instances. Google App Engine is available in this location, so it can be a Project's location for default Google Cloud resources.", + "This location supports default Cloud Storage buckets. Google App Engine is available in this location, so it can be a Project's location for default Google Cloud resources.", "Cloud Functions for Firebase is available in this location." ], "type": "string" @@ -1898,11 +1898,11 @@ "type": "array" }, "locationId": { - "description": "The ID of the GCP resource location. It will be one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations#types).", + "description": "The ID of the Project's location for default Google Cloud resources. It will be one of the available [Google App Engine locations](https://cloud.google.com/about/locations#region).", "type": "string" }, "type": { - "description": "Indicates whether the GCP resource location is a [regional or multi-regional location](https://firebase.google.com/docs/projects/locations#types) for data replication.", + "description": "Indicates whether the location for default Google Cloud resources is a [regional or multi-regional location](https://firebase.google.com/docs/projects/locations#types) for data replication.", "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", @@ -1980,19 +1980,19 @@ "type": "object" }, "ProjectInfo": { - "description": "A reference to a Google Cloud Platform (GCP) `Project`.", + "description": "A reference to a Google Cloud `Project`.", "id": "ProjectInfo", "properties": { "displayName": { - "description": "The user-assigned display name of the GCP `Project`, for example: `My App`", + "description": "The user-assigned display name of the Google Cloud `Project`, for example: `My App`.", "type": "string" }, "locationId": { - "description": "The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). Not all Projects will have this field populated. If it is not populated, it means that the Project does not yet have a default GCP resource location. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.", + "description": "**DEPRECATED** _Instead, use product-specific REST APIs to work with the location of each resource in a Project. This field may not be populated, especially for newly provisioned projects after October 30, 2024._ The ID of the Project's [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location). The location is one of the available [Google App Engine locations](https://cloud.google.com/about/locations#region). Not all Projects will have this field populated. If it is not populated, it means that the Project does not yet have a location for default Google Cloud resources.", "type": "string" }, "project": { - "description": "The resource name of the GCP `Project` to which Firebase resources can be added, in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values.", + "description": "The resource name of the Google Cloud `Project` to which Firebase resources can be added, in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects#FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values.", "type": "string" } }, @@ -2323,12 +2323,12 @@ }, "databaseURL": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, find the default Firebase Realtime Database instance name using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. Note that the default instance for the Project might not yet be provisioned, so the return might not contain a default instance._ The default Firebase Realtime Database URL.", + "description": "**DEPRECATED.** _Instead, find the URL of the default Realtime Database instance using the [list endpoint](https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) within the Firebase Realtime Database REST API. If the default instance for the Project has not yet been provisioned, the return might not contain a default instance. Note that the config that's generated for the Firebase console or the Firebase CLI uses the Realtime Database endpoint to populate this value for that config._ The URL of the default Firebase Realtime Database instance.", "type": "string" }, "locationId": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to find the location of resources._ The ID of the Project's default GCP resource location. The location is one of the available [GCP resource locations](https://firebase.google.com/docs/projects/locations). This field is omitted if the default GCP resource location has not been finalized yet. To set a Project's default GCP resource location, call [`FinalizeDefaultLocation`](../projects.defaultLocation/finalize) after you add Firebase resources to the Project.", + "description": "**DEPRECATED.** _Instead, use product-specific REST APIs to find the location of each resource in a Project. This field may not be populated, especially for newly provisioned projects after October 30, 2024._ The ID of the Project's [\"location for default Google Cloud resources\"](https://firebase.google.com/docs/projects/locations#default-cloud-location), which are resources associated with Google App Engine. The location is one of the available [App Engine locations](https://cloud.google.com/about/locations#region). This field is omitted if the location for default Google Cloud resources has not been set.", "type": "string" }, "measurementId": { @@ -2349,12 +2349,12 @@ "type": "string" }, "realtimeDatabaseUrl": { - "description": "Optional. Duplicate field for the URL of the default RTDB instances (if there is one) that uses the same field name as the unified V2 config file format. We wanted to make a single config file format for all the app platforms (Android, iOS and web) and we had to pick consistent names for all the fields since there was some varience between the platforms. If the request asks for the V2 format we will populate this field instead of realtime_database_instance_uri.", + "description": "Optional. Duplicate field for the URL of the default Realtime Database instances (if the default instance has been provisioned). If the request asks for the V2 config format, this field will be populated instead of `realtime_database_instance_uri`.", "type": "string" }, "storageBucket": { "deprecated": true, - "description": "**DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket name.", + "description": "**DEPRECATED.** _Instead, find the name of the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. If the default bucket for the Project has not yet been provisioned, the return might not contain a default bucket. Note that the config that's generated for the Firebase console or the Firebase CLI uses the Cloud Storage for Firebase endpoint to populate this value for that config._ The name of the default Cloud Storage for Firebase bucket.", "type": "string" }, "version": { diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 20bb53574d..606bc84472 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -279,12 +279,14 @@ type ProjectsWebAppsService struct { // AddFirebaseRequest: All fields are required. type AddFirebaseRequest struct { - // LocationId: Deprecated. Instead, to set a Project's default GCP resource - // location, call `FinalizeDefaultLocation` - // (../projects.defaultLocation/finalize) after you add Firebase resources to - // the GCP `Project`. The ID of the Project's default GCP resource location. - // The location must be one of the available GCP resource locations - // (https://firebase.google.com/docs/projects/locations). + // LocationId: **DEPRECATED.** _Instead, use product-specific REST APIs to work + // with the location of each resource in a Project. This field may be ignored, + // especially for newly provisioned projects after October 30, 2024._ The ID of + // the Project's "location for default Google Cloud resources" + // (https://firebase.google.com/docs/projects/locations#default-cloud-location), + // which are resources associated with Google App Engine. The location must be + // one of the available Google App Engine locations + // (https://cloud.google.com/about/locations#region). LocationId string `json:"locationId,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to // unconditionally include in API requests. By default, fields with empty or @@ -333,34 +335,40 @@ func (s AddGoogleAnalyticsRequest) MarshalJSON() ([]byte, error) { } type AdminSdkConfig struct { - // DatabaseURL: **DEPRECATED.** _Instead, find the default Firebase Realtime - // Database instance name using the list endpoint + // DatabaseURL: **DEPRECATED.** _Instead, find the URL of the default Realtime + // Database instance using the list endpoint // (https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) - // within the Firebase Realtime Database REST API. Note that the default - // instance for the Project might not yet be provisioned, so the return might - // not contain a default instance._ The default Firebase Realtime Database URL. + // within the Firebase Realtime Database REST API. If the default instance for + // the Project has not yet been provisioned, the return might not contain a + // default instance. Note that the config that's generated for the Firebase + // console or the Firebase CLI uses the Realtime Database endpoint to populate + // this value for that config._ The URL of the default Firebase Realtime + // Database instance. DatabaseURL string `json:"databaseURL,omitempty"` // LocationId: **DEPRECATED.** _Instead, use product-specific REST APIs to find - // the location of resources._ The ID of the Project's default GCP resource - // location. The location is one of the available GCP resource locations - // (https://firebase.google.com/docs/projects/locations). This field is omitted - // if the default GCP resource location has not been finalized yet. To set a - // Project's default GCP resource location, call `FinalizeDefaultLocation` - // (../projects.defaultLocation/finalize) after you add Firebase resources to - // the Project. + // the location of each resource in a Project. This field may not be populated, + // especially for newly provisioned projects after October 30, 2024._ The ID of + // the Project's "location for default Google Cloud resources" + // (https://firebase.google.com/docs/projects/locations#default-cloud-location), + // which are resources associated with Google App Engine. The location is one + // of the available App Engine locations + // (https://cloud.google.com/about/locations#region). This field is omitted if + // the location for default Google Cloud resources has not been set. LocationId string `json:"locationId,omitempty"` // ProjectId: Immutable. A user-assigned unique identifier for the // `FirebaseProject`. This identifier may appear in URLs or names for some // Firebase resources associated with the Project, but it should generally be // treated as a convenience alias to reference the Project. ProjectId string `json:"projectId,omitempty"` - // StorageBucket: **DEPRECATED.** _Instead, find the default Cloud Storage for - // Firebase bucket using the list endpoint + // StorageBucket: **DEPRECATED.** _Instead, find the name of the default Cloud + // Storage for Firebase bucket using the list endpoint // (https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) - // within the Cloud Storage for Firebase REST API. Note that the default bucket - // for the Project might not yet be provisioned, so the return might not - // contain a default bucket._ The default Cloud Storage for Firebase storage - // bucket name. + // within the Cloud Storage for Firebase REST API. If the default bucket for + // the Project has not yet been provisioned, the return might not contain a + // default bucket. Note that the config that's generated for the Firebase + // console or the Firebase CLI uses the Cloud Storage for Firebase endpoint to + // populate this value for that config._ The name of the default Cloud Storage + // for Firebase bucket. StorageBucket string `json:"storageBucket,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -575,12 +583,12 @@ func (s AndroidAppConfig) MarshalJSON() ([]byte, error) { // resource directly from its resource-specific API._ The default // auto-provisioned resources associated with the Project. type DefaultResources struct { - // HostingSite: Output only. **DEPRECATED.** _Instead, find the default - // Firebase Hosting site name using the ListSites + // HostingSite: Output only. **DEPRECATED.** _Instead, find the name of the + // default Firebase Hosting site using ListSites // (https://firebase.google.com/docs/reference/hosting/rest/v1beta1/projects.sites/list) - // within the Firebase Hosting REST API. Note that the default site for the - // Project might not yet be provisioned, so the return might not contain a - // default site._ The default Firebase Hosting site name, in the format: + // within the Firebase Hosting REST API. If the default Hosting site for the + // Project has not yet been provisioned, the return might not contain a default + // site._ The name of the default Firebase Hosting site, in the format: // PROJECT_ID Though rare, your `projectId` might already be used as the name // for an existing Hosting site in another project (learn more about creating // non-default, additional sites @@ -591,36 +599,39 @@ type DefaultResources struct { // `myproject123-a5c16` HostingSite string `json:"hostingSite,omitempty"` // LocationId: Output only. **DEPRECATED.** _Instead, use product-specific REST - // APIs to find the location of resources._ The ID of the Project's default GCP - // resource location. The location is one of the available GCP resource - // locations (https://firebase.google.com/docs/projects/locations). This field - // is omitted if the default GCP resource location has not been finalized yet. - // To set a Project's default GCP resource location, call - // `FinalizeDefaultLocation` (../projects.defaultLocation/finalize) after you - // add Firebase resources to the Project. + // APIs to find the location of each resource in a Project. This field may not + // be populated, especially for newly provisioned projects after October 30, + // 2024._ The ID of the Project's "location for default Google Cloud resources" + // (https://firebase.google.com/docs/projects/locations#default-cloud-location), + // which are resources associated with Google App Engine. The location is one + // of the available Google App Engine locations + // (https://cloud.google.com/about/locations#region). This field is omitted if + // the location for default Google Cloud resources has not been set. LocationId string `json:"locationId,omitempty"` // RealtimeDatabaseInstance: Output only. **DEPRECATED.** _Instead, find the - // default Firebase Realtime Database instance name using the list endpoint + // name of the default Realtime Database instance using the list endpoint // (https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) - // within the Firebase Realtime Database REST API. Note that the default - // instance for the Project might not yet be provisioned, so the return might - // not contain a default instance._ The default Firebase Realtime Database - // instance name, in the format: PROJECT_ID Though rare, your `projectId` might - // already be used as the name for an existing Realtime Database instance in - // another project (learn more about database sharding + // within the Firebase Realtime Database REST API. If the default Realtime + // Database instance for a Project has not yet been provisioned, the return + // might not contain a default instance._ The default Firebase Realtime + // Database instance name, in the format: PROJECT_ID Though rare, your + // `projectId` might already be used as the name for an existing Realtime + // Database instance in another project (learn more about database sharding // (https://firebase.google.com/docs/database/usage/sharding)). In these cases, // your `projectId` is appended with a hyphen then five alphanumeric characters // to create your default Realtime Database instance name. For example, if your // `projectId` is `myproject123`, your default database instance name might be: // `myproject123-a5c16` RealtimeDatabaseInstance string `json:"realtimeDatabaseInstance,omitempty"` - // StorageBucket: Output only. **DEPRECATED.** _Instead, find the default Cloud - // Storage for Firebase bucket using the list endpoint + // StorageBucket: Output only. **DEPRECATED.** _Instead, find the name of the + // default Cloud Storage for Firebase bucket using the list endpoint // (https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) - // within the Cloud Storage for Firebase REST API. Note that the default bucket - // for the Project might not yet be provisioned, so the return might not - // contain a default bucket._ The default Cloud Storage for Firebase storage - // bucket, in the format: PROJECT_ID.appspot.com + // within the Cloud Storage for Firebase REST API. If the default bucket for + // the Project has not yet been provisioned, the return might not contain a + // default bucket._ The name of the default Cloud Storage for Firebase bucket, + // in one of the following formats: * If provisioned _before_ October 30, 2024: + // PROJECT_ID.firebasestorage.app * If provisioned _on or after_ October 30, + // 2024: PROJECT_ID.firebasestorage.app StorageBucket string `json:"storageBucket,omitempty"` // ForceSendFields is a list of field names (e.g. "HostingSite") to // unconditionally include in API requests. By default, fields with empty or @@ -650,9 +661,12 @@ type Empty struct { } type FinalizeDefaultLocationRequest struct { - // LocationId: The ID of the Project's default GCP resource location. The - // location must be one of the available GCP resource locations - // (https://firebase.google.com/docs/projects/locations). + // LocationId: **DEPRECATED** The ID of the Project's "location for default + // Google Cloud resources" + // (https://firebase.google.com/docs/projects/locations#default-cloud-location), + // which are resources associated with Google App Engine. The location must be + // one of the available Google App Engine locations + // (https://cloud.google.com/about/locations#region). LocationId string `json:"locationId,omitempty"` // ForceSendFields is a list of field names (e.g. "LocationId") to // unconditionally include in API requests. By default, fields with empty or @@ -758,14 +772,14 @@ func (s FirebaseAppInfo) MarshalJSON() ([]byte, error) { // FirebaseProject: A `FirebaseProject` is the top-level Firebase entity. It is // the container for Firebase Apps, Firebase Hosting sites, storage systems // (Firebase Realtime Database, Cloud Firestore, Cloud Storage buckets), and -// other Firebase and Google Cloud Platform (GCP) resources. You create a -// `FirebaseProject` by calling AddFirebase and specifying an *existing* GCP -// `Project` +// other Firebase and Google Cloud resources. You create a `FirebaseProject` by +// calling AddFirebase and specifying an *existing* Google Cloud `Project` // (https://cloud.google.com/resource-manager/reference/rest/v1/projects). This -// adds Firebase resources to the existing GCP `Project`. Since a -// FirebaseProject is actually also a GCP `Project`, a `FirebaseProject` has -// the same underlying GCP identifiers (`projectNumber` and `projectId`). This -// allows for easy interop with Google APIs. +// adds Firebase resources to the existing Google Cloud `Project`. Since a +// FirebaseProject is actually also a Google Cloud `Project`, a +// `FirebaseProject` has the same underlying Google Cloud identifiers +// (`projectNumber` and `projectId`). This allows for easy interop with Google +// APIs. type FirebaseProject struct { // Annotations: A set of user-defined annotations for the FirebaseProject. // Learn more about annotations in Google's AIP-128 standard @@ -1022,8 +1036,8 @@ type ListAvailableProjectsResponse struct { // `ListAvailableProjects` to find the next group of Projects. Page tokens are // short-lived and should not be persisted. NextPageToken string `json:"nextPageToken,omitempty"` - // ProjectInfo: The list of GCP `Projects` which can have Firebase resources - // added to them. + // ProjectInfo: The list of Google Cloud `Projects` which can have Firebase + // resources added to them. ProjectInfo []*ProjectInfo `json:"projectInfo,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1163,33 +1177,32 @@ func (s ListWebAppsResponse) MarshalJSON() ([]byte, error) { // Location: **DEPRECATED.** _This Location is no longer used to determine // Firebase resource locations. Instead, consult product documentation to -// determine valid locations for each resource used in your Project._ A GCP -// resource location that can be selected for a FirebaseProject. +// determine valid locations for each resource used in your Project._ A +// "location for default Google Cloud resources" +// (https://firebase.google.com/docs/projects/locations#default-cloud-location) +// that can be selected for a FirebaseProject. These are resources associated +// with Google App Engine. type Location struct { - // Features: Products and services that are available in the GCP resource - // location. + // Features: Products and services that are available in the location for + // default Google Cloud resources. // // Possible values: // "LOCATION_FEATURE_UNSPECIFIED" - Used internally for distinguishing unset // values and is not intended for external use. // "FIRESTORE" - This location supports Cloud Firestore database instances. - // App Engine is available in this location, so it can be a Project's [default - // GCP resource - // location](//firebase.google.com/docs/projects/locations#default-cloud-locatio - // n). + // Google App Engine is available in this location, so it can be a Project's + // location for default Google Cloud resources. // "DEFAULT_STORAGE" - This location supports default Cloud Storage buckets. - // App Engine is available in this location, so it can be a Project's [default - // GCP resource - // location](//firebase.google.com/docs/projects/locations#default-cloud-locatio - // n). + // Google App Engine is available in this location, so it can be a Project's + // location for default Google Cloud resources. // "FUNCTIONS" - Cloud Functions for Firebase is available in this location. Features []string `json:"features,omitempty"` - // LocationId: The ID of the GCP resource location. It will be one of the - // available GCP resource locations - // (https://firebase.google.com/docs/projects/locations#types). + // LocationId: The ID of the Project's location for default Google Cloud + // resources. It will be one of the available Google App Engine locations + // (https://cloud.google.com/about/locations#region). LocationId string `json:"locationId,omitempty"` - // Type: Indicates whether the GCP resource location is a regional or - // multi-regional location + // Type: Indicates whether the location for default Google Cloud resources is a + // regional or multi-regional location // (https://firebase.google.com/docs/projects/locations#types) for data // replication. // @@ -1298,24 +1311,25 @@ func (s ProductMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ProjectInfo: A reference to a Google Cloud Platform (GCP) `Project`. +// ProjectInfo: A reference to a Google Cloud `Project`. type ProjectInfo struct { - // DisplayName: The user-assigned display name of the GCP `Project`, for - // example: `My App` + // DisplayName: The user-assigned display name of the Google Cloud `Project`, + // for example: `My App`. DisplayName string `json:"displayName,omitempty"` - // LocationId: The ID of the Project's default GCP resource location. The - // location is one of the available GCP resource locations - // (https://firebase.google.com/docs/projects/locations). Not all Projects will + // LocationId: **DEPRECATED** _Instead, use product-specific REST APIs to work + // with the location of each resource in a Project. This field may not be + // populated, especially for newly provisioned projects after October 30, + // 2024._ The ID of the Project's "location for default Google Cloud resources" + // (https://firebase.google.com/docs/projects/locations#default-cloud-location). + // The location is one of the available Google App Engine locations + // (https://cloud.google.com/about/locations#region). Not all Projects will // have this field populated. If it is not populated, it means that the Project - // does not yet have a default GCP resource location. To set a Project's - // default GCP resource location, call `FinalizeDefaultLocation` - // (../projects.defaultLocation/finalize) after you add Firebase resources to - // the Project. + // does not yet have a location for default Google Cloud resources. LocationId string `json:"locationId,omitempty"` - // Project: The resource name of the GCP `Project` to which Firebase resources - // can be added, in the format: projects/PROJECT_IDENTIFIER Refer to the - // `FirebaseProject` `name` (../projects#FirebaseProject.FIELDS.name) field for - // details about PROJECT_IDENTIFIER values. + // Project: The resource name of the Google Cloud `Project` to which Firebase + // resources can be added, in the format: projects/PROJECT_IDENTIFIER Refer to + // the `FirebaseProject` `name` (../projects#FirebaseProject.FIELDS.name) field + // for details about PROJECT_IDENTIFIER values. Project string `json:"project,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to // unconditionally include in API requests. By default, fields with empty or @@ -1828,21 +1842,25 @@ type WebAppConfig struct { // AuthDomain: The domain Firebase Auth configures for OAuth redirects, in the // format: PROJECT_ID.firebaseapp.com AuthDomain string `json:"authDomain,omitempty"` - // DatabaseURL: **DEPRECATED.** _Instead, find the default Firebase Realtime - // Database instance name using the list endpoint + // DatabaseURL: **DEPRECATED.** _Instead, find the URL of the default Realtime + // Database instance using the list endpoint // (https://firebase.google.com/docs/reference/rest/database/database-management/rest/v1beta/projects.locations.instances/list) - // within the Firebase Realtime Database REST API. Note that the default - // instance for the Project might not yet be provisioned, so the return might - // not contain a default instance._ The default Firebase Realtime Database URL. + // within the Firebase Realtime Database REST API. If the default instance for + // the Project has not yet been provisioned, the return might not contain a + // default instance. Note that the config that's generated for the Firebase + // console or the Firebase CLI uses the Realtime Database endpoint to populate + // this value for that config._ The URL of the default Firebase Realtime + // Database instance. DatabaseURL string `json:"databaseURL,omitempty"` // LocationId: **DEPRECATED.** _Instead, use product-specific REST APIs to find - // the location of resources._ The ID of the Project's default GCP resource - // location. The location is one of the available GCP resource locations - // (https://firebase.google.com/docs/projects/locations). This field is omitted - // if the default GCP resource location has not been finalized yet. To set a - // Project's default GCP resource location, call `FinalizeDefaultLocation` - // (../projects.defaultLocation/finalize) after you add Firebase resources to - // the Project. + // the location of each resource in a Project. This field may not be populated, + // especially for newly provisioned projects after October 30, 2024._ The ID of + // the Project's "location for default Google Cloud resources" + // (https://firebase.google.com/docs/projects/locations#default-cloud-location), + // which are resources associated with Google App Engine. The location is one + // of the available App Engine locations + // (https://cloud.google.com/about/locations#region). This field is omitted if + // the location for default Google Cloud resources has not been set. LocationId string `json:"locationId,omitempty"` // MeasurementId: The unique Google-assigned identifier of the Google Analytics // web stream associated with the `WebApp`. Firebase SDKs use this ID to @@ -1869,20 +1887,19 @@ type WebAppConfig struct { // services. ProjectNumber string `json:"projectNumber,omitempty"` // RealtimeDatabaseUrl: Optional. Duplicate field for the URL of the default - // RTDB instances (if there is one) that uses the same field name as the - // unified V2 config file format. We wanted to make a single config file format - // for all the app platforms (Android, iOS and web) and we had to pick - // consistent names for all the fields since there was some varience between - // the platforms. If the request asks for the V2 format we will populate this - // field instead of realtime_database_instance_uri. + // Realtime Database instances (if the default instance has been provisioned). + // If the request asks for the V2 config format, this field will be populated + // instead of `realtime_database_instance_uri`. RealtimeDatabaseUrl string `json:"realtimeDatabaseUrl,omitempty"` - // StorageBucket: **DEPRECATED.** _Instead, find the default Cloud Storage for - // Firebase bucket using the list endpoint + // StorageBucket: **DEPRECATED.** _Instead, find the name of the default Cloud + // Storage for Firebase bucket using the list endpoint // (https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) - // within the Cloud Storage for Firebase REST API. Note that the default bucket - // for the Project might not yet be provisioned, so the return might not - // contain a default bucket._ The default Cloud Storage for Firebase storage - // bucket name. + // within the Cloud Storage for Firebase REST API. If the default bucket for + // the Project has not yet been provisioned, the return might not contain a + // default bucket. Note that the config that's generated for the Firebase + // console or the Firebase CLI uses the Cloud Storage for Firebase endpoint to + // populate this value for that config._ The name of the default Cloud Storage + // for Firebase bucket. StorageBucket string `json:"storageBucket,omitempty"` // Version: Version of the config specification. Version string `json:"version,omitempty"` @@ -1915,13 +1932,14 @@ type AvailableProjectsListCall struct { header_ http.Header } -// List: Lists each [Google Cloud Platform (GCP) `Project`] +// List: Lists each Google Cloud `Project` // (https://cloud.google.com/resource-manager/reference/rest/v1/projects) that -// can have Firebase resources added to it. A Project will only be listed if: - -// The caller has sufficient Google IAM (https://cloud.google.com/iam) -// permissions to call AddFirebase. - The Project is not already a -// FirebaseProject. - The Project is not in an Organization which has policies -// that prevent Firebase resources from being added. +// can have Firebase resources added and Firebase services enabled. A Project +// will only be listed if: - The caller has sufficient Google IAM +// (https://cloud.google.com/iam) permissions to call AddFirebase. - The +// Project is not already a FirebaseProject. - The Project is not in an +// Organization which has policies that prevent Firebase resources from being +// added. func (r *AvailableProjectsService) List() *AvailableProjectsListCall { c := &AvailableProjectsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -2171,37 +2189,39 @@ type ProjectsAddFirebaseCall struct { header_ http.Header } -// AddFirebase: Adds Firebase resources to the specified existing [Google Cloud -// Platform (GCP) `Project`] +// AddFirebase: Adds Firebase resources and enables Firebase services in the +// specified existing Google Cloud `Project` // (https://cloud.google.com/resource-manager/reference/rest/v1/projects). -// Since a FirebaseProject is actually also a GCP `Project`, a -// `FirebaseProject` has the same underlying GCP identifiers (`projectNumber` -// and `projectId`). This allows for easy interop with Google APIs. The result -// of this call is an `Operation` (../../v1beta1/operations). Poll the -// `Operation` to track the provisioning process by calling GetOperation until -// `done` (../../v1beta1/operations#Operation.FIELDS.done) is `true`. When -// `done` is `true`, the `Operation` has either succeeded or failed. If the -// `Operation` succeeded, its `response` +// Since a FirebaseProject is actually also a Google Cloud `Project`, a +// `FirebaseProject` has the same underlying Google Cloud identifiers +// (`projectNumber` and `projectId`). This allows for easy interop with Google +// APIs. The result of this call is an `Operation` (../../v1beta1/operations). +// Poll the `Operation` to track the provisioning process by calling +// GetOperation until `done` (../../v1beta1/operations#Operation.FIELDS.done) +// is `true`. When `done` is `true`, the `Operation` has either succeeded or +// failed. If the `Operation` succeeded, its `response` // (../../v1beta1/operations#Operation.FIELDS.response) is set to a // FirebaseProject; if the `Operation` failed, its `error` // (../../v1beta1/operations#Operation.FIELDS.error) is set to a // google.rpc.Status. The `Operation` is automatically deleted after // completion, so there is no need to call DeleteOperation. This method does -// not modify any billing account information on the underlying GCP `Project`. -// To call `AddFirebase`, a project member or service account must have the -// following permissions (the IAM roles of Editor and Owner contain these -// permissions): `firebase.projects.update`, `resourcemanager.projects.get`, -// `serviceusage.services.enable`, and `serviceusage.services.get`. +// not modify any billing account information on the underlying Google Cloud +// `Project`. To call `AddFirebase`, a project member or service account must +// have the following permissions (the IAM roles of Editor and Owner contain +// these permissions): `firebase.projects.update`, +// `resourcemanager.projects.get`, `serviceusage.services.enable`, and +// `serviceusage.services.get`. // -// - project: The resource name of the GCP `Project` to which Firebase -// resources will be added, in the format: projects/PROJECT_IDENTIFIER Refer -// to the `FirebaseProject` `name` (../projects#FirebaseProject.FIELDS.name) -// field for details about PROJECT_IDENTIFIER values. After calling -// `AddFirebase`, the unique Project identifiers ( `projectNumber` +// - project: The resource name of the Google Cloud `Project` in which Firebase +// resources will be added and Firebase services enabled, in the format: +// projects/ PROJECT_IDENTIFIER Refer to the `FirebaseProject` `name` +// (../projects#FirebaseProject.FIELDS.name) field for details about +// PROJECT_IDENTIFIER values. After calling `AddFirebase`, the unique Project +// identifiers ( `projectNumber` // (https://cloud.google.com/resource-manager/reference/rest/v1/projects#Project.FIELDS.project_number) // and `projectId` // (https://cloud.google.com/resource-manager/reference/rest/v1/projects#Project.FIELDS.project_id)) -// of the underlying GCP `Project` are also the identifiers of the +// of the underlying Google Cloud `Project` are also the identifiers of the // FirebaseProject. func (r *ProjectsService) AddFirebase(projectid string, addfirebaserequest *AddFirebaseRequest) *ProjectsAddFirebaseCall { c := &ProjectsAddFirebaseCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -4506,28 +4526,33 @@ type ProjectsAvailableLocationsListCall struct { header_ http.Header } -// List: **DEPRECATED.** _Instead, use the applicable resource-specific REST -// API (or associated documentation, as needed) to determine valid locations -// for each resource used in your Project._ Lists the valid Google Cloud -// Platform (GCP) resource locations for the specified Project (including a -// FirebaseProject). One of these locations can be selected as the Project's -// _default_ GCP resource location -// (https://firebase.google.com/docs/projects/locations), which is the -// geographical location where the Project's resources, such as Cloud -// Firestore, will be provisioned by default. However, if the default GCP -// resource location has already been set for the Project, then this setting -// cannot be changed. This call checks for any possible location restrictions +// List: **DECOMMISSIONED.** **If called, this endpoint will return a 404 +// error.** _Instead, use the applicable resource-specific REST API (or +// associated documentation, as needed) to determine valid locations for each +// resource used in your Project._ Lists the valid "locations for default +// Google Cloud resources" +// (https://firebase.google.com/docs/projects/locations#default-cloud-location) +// for the specified Project (including a FirebaseProject). One of these +// locations can be selected as the Project's location for default Google Cloud +// resources, which is the geographical location where the Project's resources +// associated with Google App Engine (such as the default Cloud Firestore +// instance) will be provisioned by default. However, if the location for +// default Google Cloud resources has already been set for the Project, then +// this setting cannot be changed. This call checks for any possible location +// restrictions // (https://cloud.google.com/resource-manager/docs/organization-policy/defining-locations) // for the specified Project and, thus, might return a subset of all possible -// GCP resource locations. To list all GCP resource locations (regardless of -// any restrictions), call the endpoint without specifying a unique project -// identifier (that is, `/v1beta1/{parent=projects/-}/listAvailableLocations`). -// To call `ListAvailableLocations` with a specified project, a member must be -// at minimum a Viewer of the Project. Calls without a specified project do not +// locations. To list all locations (regardless of any restrictions), call the +// endpoint without specifying a unique project identifier (that is, +// `/v1beta1/{parent=projects/-}/listAvailableLocations`). To call +// `ListAvailableLocations` with a specified project, a member must be at +// minimum a Viewer of the Project. Calls without a specified project do not // require any specific project permissions. // -// - parent: The FirebaseProject for which to list GCP resource locations, in -// the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` +// - parent: The FirebaseProject for which to list locations for default Google +// Cloud resources +// (https://firebase.google.com/docs/projects/locations#default-cloud-location), +// in the format: projects/PROJECT_IDENTIFIER Refer to the `FirebaseProject` // `name` (../projects#FirebaseProject.FIELDS.name) field for details about // PROJECT_IDENTIFIER values. If no unique project identifier is specified // (that is, `projects/-`), the returned list does not take into account @@ -4676,23 +4701,24 @@ type ProjectsDefaultLocationFinalizeCall struct { header_ http.Header } -// Finalize: **DEPRECATED.** _Instead, use the applicable resource-specific -// REST API to set the location for each resource used in your Project._ Sets -// the default Google Cloud Platform (GCP) resource location for the specified -// FirebaseProject. This method creates an App Engine application with a -// default Cloud Storage bucket +// Finalize: **DECOMMISSIONED.** **If called, this endpoint will return a 404 +// error.** _Instead, use the applicable resource-specific REST API to set the +// location for each resource used in your Project._ Sets the "location for +// default Google Cloud resources" +// (https://firebase.google.com/docs/projects/locations#default-cloud-location) +// for the specified FirebaseProject. This method creates a Google App Engine +// application with a default Cloud Storage bucket // (https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket), // located in the specified `locationId` // (#body.request_body.FIELDS.location_id). This location must be one of the -// available GCP resource locations -// (https://firebase.google.com/docs/projects/locations). After the default GCP -// resource location is finalized, or if it was already set, it cannot be -// changed. The default GCP resource location for the specified -// `FirebaseProject` might already be set because either the underlying GCP -// `Project` already has an App Engine application or `FinalizeDefaultLocation` -// was previously called with a specified `locationId`. Any new calls to -// `FinalizeDefaultLocation` with a *different* specified `locationId` will -// return a 409 error. The result of this call is an `Operation` +// available App Engine locations +// (https://cloud.google.com/about/locations#region). After the location for +// default Google Cloud resources is finalized, or if it was already set, it +// cannot be changed. The location for default Google Cloud resources for the +// specified `FirebaseProject` might already be set because either the +// underlying Google Cloud `Project` already has an App Engine application or +// `FinalizeDefaultLocation` was previously called with a specified +// `locationId`. The result of this call is an `Operation` // (../../v1beta1/operations), which can be used to track the provisioning // process. The `response` (../../v1beta1/operations#Operation.FIELDS.response) // type of the `Operation` is google.protobuf.Empty. The `Operation` can be @@ -4706,11 +4732,12 @@ type ProjectsDefaultLocationFinalizeCall struct { // in the request body (#request-body) are required. To call // `FinalizeDefaultLocation`, a member must be an Owner of the Project. // -// - parent: The resource name of the FirebaseProject for which the default GCP -// resource location will be set, in the format: projects/PROJECT_IDENTIFIER -// Refer to the `FirebaseProject` `name` -// (../projects#FirebaseProject.FIELDS.name) field for details about -// PROJECT_IDENTIFIER values. +// - parent: The resource name of the FirebaseProject for which the "location +// for default Google Cloud resources" +// (https://firebase.google.com/docs/projects/locations#default-cloud-location) +// will be set, in the format: projects/PROJECT_IDENTIFIER Refer to the +// `FirebaseProject` `name` (../projects#FirebaseProject.FIELDS.name) field +// for details about PROJECT_IDENTIFIER values. func (r *ProjectsDefaultLocationService) Finalize(parent string, finalizedefaultlocationrequest *FinalizeDefaultLocationRequest) *ProjectsDefaultLocationFinalizeCall { c := &ProjectsDefaultLocationFinalizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/searchads360/v0/searchads360-api.json b/searchads360/v0/searchads360-api.json index 87bdc0fa93..e5297529c7 100644 --- a/searchads360/v0/searchads360-api.json +++ b/searchads360/v0/searchads360-api.json @@ -260,7 +260,7 @@ } } }, - "revision": "20241002", + "revision": "20241108", "rootUrl": "https://searchads360.googleapis.com/", "schemas": { "GoogleAdsSearchads360V0Common__AdScheduleInfo": { @@ -4225,6 +4225,14 @@ "readOnly": true, "type": "string" }, + "effectiveLabels": { + "description": "Output only. The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "engineId": { "description": "Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use \"ad_group_ad.ad.id\" instead.", "readOnly": true, @@ -4336,6 +4344,31 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel": { + "description": "A relationship between an ad group ad and an effective label. An effective label is a label inherited or directly assigned to this ad group ad.", + "id": "GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel", + "properties": { + "adGroupAd": { + "description": "Immutable. The ad group ad to which the effective label is attached.", + "type": "string" + }, + "label": { + "description": "Immutable. The effective label assigned to the ad group ad.", + "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 ad effective label. Ad group ad effective label resource names have the form: `customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}`", + "type": "string" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Resources__AdGroupAdLabel": { "description": "A relationship between an ad group ad and a label.", "id": "GoogleAdsSearchads360V0Resources__AdGroupAdLabel", @@ -4505,6 +4538,14 @@ "readOnly": true, "type": "string" }, + "effectiveLabels": { + "description": "Output only. The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "engineId": { "description": "Output only. ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use \"ad_group_criterion.criterion_id\" instead.", "readOnly": true, @@ -4764,6 +4805,31 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel": { + "description": "A relationship between an ad group criterion and an effective label. An effective label is a label inherited or directly assigned to this ad group criterion.", + "id": "GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel", + "properties": { + "adGroupCriterion": { + "description": "Immutable. The ad group criterion to which the effective label is attached.", + "type": "string" + }, + "label": { + "description": "Immutable. The effective label assigned to the ad group criterion.", + "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 criterion effective label. Ad group criterion effective label resource names have the form: `customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}`", + "type": "string" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel": { "description": "A relationship between an ad group criterion and a label.", "id": "GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel", @@ -8099,6 +8165,29 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Resources__UserLocationView": { + "description": "A user location view. User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.", + "id": "GoogleAdsSearchads360V0Resources__UserLocationView", + "properties": { + "countryCriterionId": { + "description": "Output only. Criterion Id for the country.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "resourceName": { + "description": "Output only. The resource name of the user location view. UserLocation view resource names have the form: `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`", + "readOnly": true, + "type": "string" + }, + "targetingLocation": { + "description": "Output only. Indicates whether location was targeted or not.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Resources__Visit": { "description": "A visit.", "id": "GoogleAdsSearchads360V0Resources__Visit", @@ -8397,6 +8486,10 @@ "$ref": "GoogleAdsSearchads360V0Resources__AdGroupAd", "description": "The ad referenced in the query." }, + "adGroupAdEffectiveLabel": { + "$ref": "GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel", + "description": "The ad group ad effective label referenced in the query." + }, "adGroupAdLabel": { "$ref": "GoogleAdsSearchads360V0Resources__AdGroupAdLabel", "description": "The ad group ad label referenced in the query." @@ -8421,6 +8514,10 @@ "$ref": "GoogleAdsSearchads360V0Resources__AdGroupCriterion", "description": "The criterion referenced in the query." }, + "adGroupCriterionEffectiveLabel": { + "$ref": "GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel", + "description": "The ad group criterion effective label referenced in the query." + }, "adGroupCriterionLabel": { "$ref": "GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel", "description": "The ad group criterion label referenced in the query." @@ -8604,6 +8701,10 @@ "$ref": "GoogleAdsSearchads360V0Resources__UserList", "description": "The user list referenced in the query." }, + "userLocationView": { + "$ref": "GoogleAdsSearchads360V0Resources__UserLocationView", + "description": "The user location view referenced in the query." + }, "visit": { "$ref": "GoogleAdsSearchads360V0Resources__Visit", "description": "The event level visit referenced in the query." diff --git a/searchads360/v0/searchads360-gen.go b/searchads360/v0/searchads360-gen.go index 42b8ad7ff4..e083e9f427 100644 --- a/searchads360/v0/searchads360-gen.go +++ b/searchads360/v0/searchads360-gen.go @@ -4725,6 +4725,10 @@ type GoogleAdsSearchads360V0Resources__AdGroupAd struct { // The datetime is in the customer's time zone and in "yyyy-MM-dd // HH:mm:ss.ssssss" format. CreationTime string `json:"creationTime,omitempty"` + // EffectiveLabels: Output only. The resource names of effective labels + // attached to this ad. An effective label is a label inherited or directly + // assigned to this ad. + EffectiveLabels []string `json:"effectiveLabels,omitempty"` // EngineId: Output only. ID of the ad in the external engine account. This // field is for Search Ads 360 account only, for example, Yahoo Japan, // Microsoft, Baidu etc. For non-Search Ads 360 entity, use "ad_group_ad.ad.id" @@ -4801,6 +4805,41 @@ func (s GoogleAdsSearchads360V0Resources__AdGroupAd) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel: A relationship +// between an ad group ad and an effective label. An effective label is a label +// inherited or directly assigned to this ad group ad. +type GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel struct { + // AdGroupAd: Immutable. The ad group ad to which the effective label is + // attached. + AdGroupAd string `json:"adGroupAd,omitempty"` + // Label: Immutable. The effective label assigned to the ad group ad. + 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 ad effective + // label. Ad group ad effective label resource names have the form: + // `customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{labe + // l_id}` + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdGroupAd") 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. "AdGroupAd") 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__AdGroupAdEffectiveLabel) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Resources__AdGroupAdLabel: A relationship between an // ad group ad and a label. type GoogleAdsSearchads360V0Resources__AdGroupAdLabel struct { @@ -5004,6 +5043,10 @@ type GoogleAdsSearchads360V0Resources__AdGroupCriterion struct { CriterionId int64 `json:"criterionId,omitempty,string"` // EffectiveCpcBidMicros: Output only. The effective CPC (cost-per-click) bid. EffectiveCpcBidMicros int64 `json:"effectiveCpcBidMicros,omitempty,string"` + // EffectiveLabels: Output only. The resource names of effective labels + // attached to this ad group criterion. An effective label is a label inherited + // or directly assigned to this ad group criterion. + EffectiveLabels []string `json:"effectiveLabels,omitempty"` // EngineId: Output only. ID of the ad group criterion in the external engine // account. This field is for non-Google Ads account only, for example, Yahoo // Japan, Microsoft, Baidu etc. For Google Ads entity, use @@ -5182,6 +5225,43 @@ func (s *GoogleAdsSearchads360V0Resources__AdGroupCriterion) UnmarshalJSON(data return nil } +// GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel: A +// relationship between an ad group criterion and an effective label. An +// effective label is a label inherited or directly assigned to this ad group +// criterion. +type GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel struct { + // AdGroupCriterion: Immutable. The ad group criterion to which the effective + // label is attached. + AdGroupCriterion string `json:"adGroupCriterion,omitempty"` + // Label: Immutable. The effective label assigned to the ad group criterion. + 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 criterion + // effective label. Ad group criterion effective label resource names have the + // form: + // `customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{crite + // rion_id}~{label_id}` + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdGroupCriterion") 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. "AdGroupCriterion") 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__AdGroupCriterionEffectiveLabel) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel: A relationship // between an ad group criterion and a label. type GoogleAdsSearchads360V0Resources__AdGroupCriterionLabel struct { @@ -8274,6 +8354,40 @@ func (s GoogleAdsSearchads360V0Resources__UserList) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAdsSearchads360V0Resources__UserLocationView: A user location view. +// User Location View includes all metrics aggregated at the country level, one +// row per country. It reports metrics at the actual physical location of the +// user by targeted or not targeted location. If other segment fields are used, +// you may get more than one row per country. +type GoogleAdsSearchads360V0Resources__UserLocationView struct { + // CountryCriterionId: Output only. Criterion Id for the country. + CountryCriterionId int64 `json:"countryCriterionId,omitempty,string"` + // ResourceName: Output only. The resource name of the user location view. + // UserLocation view resource names have the form: + // `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_ + // location}` + ResourceName string `json:"resourceName,omitempty"` + // TargetingLocation: Output only. Indicates whether location was targeted or + // not. + TargetingLocation bool `json:"targetingLocation,omitempty"` + // ForceSendFields is a list of field names (e.g. "CountryCriterionId") 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. "CountryCriterionId") 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__UserLocationView) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Resources__UserLocationView + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Resources__Visit: A visit. type GoogleAdsSearchads360V0Resources__Visit struct { // AdId: Output only. Ad ID. A value of 0 indicates that the ad is @@ -8598,6 +8712,9 @@ type GoogleAdsSearchads360V0Services__SearchAds360Row struct { AdGroup *GoogleAdsSearchads360V0Resources__AdGroup `json:"adGroup,omitempty"` // AdGroupAd: The ad referenced in the query. AdGroupAd *GoogleAdsSearchads360V0Resources__AdGroupAd `json:"adGroupAd,omitempty"` + // AdGroupAdEffectiveLabel: The ad group ad effective label referenced in the + // query. + AdGroupAdEffectiveLabel *GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel `json:"adGroupAdEffectiveLabel,omitempty"` // AdGroupAdLabel: The ad group ad label referenced in the query. AdGroupAdLabel *GoogleAdsSearchads360V0Resources__AdGroupAdLabel `json:"adGroupAdLabel,omitempty"` // AdGroupAsset: The ad group asset referenced in the query. @@ -8610,6 +8727,9 @@ type GoogleAdsSearchads360V0Services__SearchAds360Row struct { AdGroupBidModifier *GoogleAdsSearchads360V0Resources__AdGroupBidModifier `json:"adGroupBidModifier,omitempty"` // AdGroupCriterion: The criterion referenced in the query. AdGroupCriterion *GoogleAdsSearchads360V0Resources__AdGroupCriterion `json:"adGroupCriterion,omitempty"` + // AdGroupCriterionEffectiveLabel: The ad group criterion effective label + // referenced in the query. + AdGroupCriterionEffectiveLabel *GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel `json:"adGroupCriterionEffectiveLabel,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. @@ -8707,6 +8827,8 @@ type GoogleAdsSearchads360V0Services__SearchAds360Row struct { ShoppingPerformanceView *GoogleAdsSearchads360V0Resources__ShoppingPerformanceView `json:"shoppingPerformanceView,omitempty"` // UserList: The user list referenced in the query. UserList *GoogleAdsSearchads360V0Resources__UserList `json:"userList,omitempty"` + // UserLocationView: The user location view referenced in the query. + UserLocationView *GoogleAdsSearchads360V0Resources__UserLocationView `json:"userLocationView,omitempty"` // Visit: The event level visit referenced in the query. Visit *GoogleAdsSearchads360V0Resources__Visit `json:"visit,omitempty"` // WebpageView: The webpage view referenced in the query. diff --git a/testing/v1/testing-api.json b/testing/v1/testing-api.json index 5bb5e7d6db..cd2b5ba589 100644 --- a/testing/v1/testing-api.json +++ b/testing/v1/testing-api.json @@ -449,7 +449,7 @@ } } }, - "revision": "20240917", + "revision": "20241105", "rootUrl": "https://testing.googleapis.com/", "schemas": { "Account": { @@ -972,12 +972,18 @@ "type": "array" }, "usesPermission": { - "description": "Permissions declared to be used by the application", "items": { "type": "string" }, "type": "array" }, + "usesPermissionTags": { + "description": "Permissions declared to be used by the application", + "items": { + "$ref": "UsesPermissionTag" + }, + "type": "array" + }, "versionCode": { "description": "Version number used internally by the app.", "format": "int64", @@ -2819,6 +2825,22 @@ }, "type": "object" }, + "UsesPermissionTag": { + "description": "The tag within a manifest. https://developer.android.com/guide/topics/manifest/uses-permission-element.html", + "id": "UsesPermissionTag", + "properties": { + "maxSdkVersion": { + "description": "The android:name value", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "The android:name value", + "type": "string" + } + }, + "type": "object" + }, "XcodeVersion": { "description": "An Xcode version that an iOS version is compatible with.", "id": "XcodeVersion", diff --git a/testing/v1/testing-gen.go b/testing/v1/testing-gen.go index 7bb8ad09cc..1392d5240d 100644 --- a/testing/v1/testing-gen.go +++ b/testing/v1/testing-gen.go @@ -737,9 +737,10 @@ type ApkManifest struct { // designed to run. TargetSdkVersion int64 `json:"targetSdkVersion,omitempty"` // UsesFeature: Feature usage tags defined in the manifest. - UsesFeature []*UsesFeature `json:"usesFeature,omitempty"` - // UsesPermission: Permissions declared to be used by the application - UsesPermission []string `json:"usesPermission,omitempty"` + UsesFeature []*UsesFeature `json:"usesFeature,omitempty"` + UsesPermission []string `json:"usesPermission,omitempty"` + // UsesPermissionTags: Permissions declared to be used by the application + UsesPermissionTags []*UsesPermissionTag `json:"usesPermissionTags,omitempty"` // VersionCode: Version number used internally by the app. VersionCode int64 `json:"versionCode,omitempty,string"` // VersionName: Version number shown to users. @@ -3119,6 +3120,31 @@ func (s UsesFeature) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UsesPermissionTag: The tag within a manifest. +// https://developer.android.com/guide/topics/manifest/uses-permission-element.html +type UsesPermissionTag struct { + // MaxSdkVersion: The android:name value + MaxSdkVersion int64 `json:"maxSdkVersion,omitempty"` + // Name: The android:name value + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "MaxSdkVersion") 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. "MaxSdkVersion") 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 UsesPermissionTag) MarshalJSON() ([]byte, error) { + type NoMethod UsesPermissionTag + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // XcodeVersion: An Xcode version that an iOS version is compatible with. type XcodeVersion struct { // Tags: Tags for this Xcode version. Example: "default".