diff --git a/CHANGES.md b/CHANGES.md index 58f8136890..ab739889fc 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,17 @@ # Changes +## [0.227.0](https://github.com/googleapis/google-api-go-client/compare/v0.226.0...v0.227.0) (2025-03-19) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#3064](https://github.com/googleapis/google-api-go-client/issues/3064)) ([086437d](https://github.com/googleapis/google-api-go-client/commit/086437d5503dc5cc6794bbbfec47cdd90c8b917b)) +* **all:** Auto-regenerate discovery clients ([#3066](https://github.com/googleapis/google-api-go-client/issues/3066)) ([2920346](https://github.com/googleapis/google-api-go-client/commit/29203469556eca18b77dcf2f92163047218b5ad7)) +* **all:** Auto-regenerate discovery clients ([#3067](https://github.com/googleapis/google-api-go-client/issues/3067)) ([c6396b1](https://github.com/googleapis/google-api-go-client/commit/c6396b197caa96a22a79dc8f993d8a216e7959db)) +* **all:** Auto-regenerate discovery clients ([#3069](https://github.com/googleapis/google-api-go-client/issues/3069)) ([f12f503](https://github.com/googleapis/google-api-go-client/commit/f12f50392dc68907c5616e8d436d7daafa2d9967)) +* **all:** Auto-regenerate discovery clients ([#3070](https://github.com/googleapis/google-api-go-client/issues/3070)) ([a5a7982](https://github.com/googleapis/google-api-go-client/commit/a5a7982eab05780caeb754e4b489d3c1ff0d868c)) +* **all:** Auto-regenerate discovery clients ([#3071](https://github.com/googleapis/google-api-go-client/issues/3071)) ([a86ed9f](https://github.com/googleapis/google-api-go-client/commit/a86ed9f6305ee23b7290ee047847ddcdf51c4792)) + ## [0.226.0](https://github.com/googleapis/google-api-go-client/compare/v0.225.0...v0.226.0) (2025-03-13) diff --git a/accesscontextmanager/v1/accesscontextmanager-api.json b/accesscontextmanager/v1/accesscontextmanager-api.json index 01085fcd8f..847ae4cce8 100644 --- a/accesscontextmanager/v1/accesscontextmanager-api.json +++ b/accesscontextmanager/v1/accesscontextmanager-api.json @@ -1295,7 +1295,7 @@ } } }, - "revision": "20250212", + "revision": "20250312", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1854,6 +1854,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -2051,6 +2058,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index 74166cb7d6..81ddd1b4c1 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -1125,6 +1125,10 @@ type EgressTo struct { // this list. If `*` is specified for `resources`, then this EgressTo rule will // authorize access to all resources outside the perimeter. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding EgressFrom. are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1459,6 +1463,10 @@ type IngressTo struct { // `*` is specified, then access to all resources inside the perimeter are // allowed. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding IngressFrom are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "Operations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/adsense/v2/adsense-api.json b/adsense/v2/adsense-api.json index 57622283d3..99b2001b68 100644 --- a/adsense/v2/adsense-api.json +++ b/adsense/v2/adsense-api.json @@ -2018,7 +2018,7 @@ } } }, - "revision": "20250224", + "revision": "20250313", "rootUrl": "https://adsense.googleapis.com/", "schemas": { "Account": { @@ -2679,7 +2679,7 @@ "Ad serving demand has been restricted on the entity.", "Ad serving has been disabled on the entity.", "Ads are being served for the entity but Confirmed Click is being applied to the ads. See https://support.google.com/adsense/answer/10025624.", - "Ad personalization is restricted because the ad requests coming from the EEA and UK do not have a TCF string or the Consent Management Platform (CMP) indicated by the TCF string is not Google certified. As a result, basic/limited ads will be served. See https://support.google.com/adsense/answer/13554116" + "Ad personalization is restricted because the ad requests coming from the EEA and UK do not have a TCF string or the Consent Management Platform (CMP) indicated by the TCF string is not Google certified. As a result, basic/limited ads will be served. See https://support.google.com/adsense/answer/13554116." ], "type": "string" }, @@ -2772,7 +2772,7 @@ ], "enumDescriptions": [ "The type is unspecified.", - "Topics that are primarily related to the Google Publisher Policy (GPP) https://support.google.com/publisherpolicies/answer/10502938 or the Google Publisher Restrictions (GPR) policies https://support.google.com/publisherpolicies/answer/10437795.", + "Topics that are primarily related to the Google Publisher Policy (GPP) (https://support.google.com/publisherpolicies/answer/10502938) or the Google Publisher Restrictions (GPR) policies (https://support.google.com/publisherpolicies/answer/10437795).", "Topics that are related to advertiser preferences. Certain advertisers may choose not to bid on content that are labeled with certain policies.", "Any topics that are a result of a country or regional regulatory requirement body." ], diff --git a/adsense/v2/adsense-gen.go b/adsense/v2/adsense-gen.go index ae5dbe4711..6e277f477f 100644 --- a/adsense/v2/adsense-gen.go +++ b/adsense/v2/adsense-gen.go @@ -1227,7 +1227,7 @@ type PolicyIssue struct { // the ad requests coming from the EEA and UK do not have a TCF string or the // Consent Management Platform (CMP) indicated by the TCF string is not Google // certified. As a result, basic/limited ads will be served. See - // https://support.google.com/adsense/answer/13554116 + // https://support.google.com/adsense/answer/13554116. Action string `json:"action,omitempty"` // AdClients: Optional. List of ad clients associated with the policy issue // (either as the primary ad client or an associated host/secondary ad client). @@ -1316,9 +1316,9 @@ type PolicyTopic struct { // Possible values: // "POLICY_TOPIC_TYPE_UNSPECIFIED" - The type is unspecified. // "POLICY" - Topics that are primarily related to the Google Publisher - // Policy (GPP) https://support.google.com/publisherpolicies/answer/10502938 or - // the Google Publisher Restrictions (GPR) policies - // https://support.google.com/publisherpolicies/answer/10437795. + // Policy (GPP) (https://support.google.com/publisherpolicies/answer/10502938) + // or the Google Publisher Restrictions (GPR) policies + // (https://support.google.com/publisherpolicies/answer/10437795). // "ADVERTISER_PREFERENCE" - Topics that are related to advertiser // preferences. Certain advertisers may choose not to bid on content that are // labeled with certain policies. diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index 924ff0285e..1c451ca9a0 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -19449,7 +19449,7 @@ } } }, - "revision": "20250226", + "revision": "20250307", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -23617,7 +23617,7 @@ "type": "integer" }, "bootDiskType": { - "description": "Type of the boot disk (default is \"pd-ssd\"). Valid values: \"pd-ssd\" (Persistent Disk Solid State Drive) or \"pd-standard\" (Persistent Disk Hard Disk Drive).", + "description": "Type of the boot disk. For non-A3U machines, the default value is \"pd-ssd\", for A3U machines, the default value is \"hyperdisk-balanced\". Valid values: \"pd-ssd\" (Persistent Disk Solid State Drive), \"pd-standard\" (Persistent Disk Hard Disk Drive) or \"hyperdisk-balanced\".", "type": "string" } }, @@ -27228,6 +27228,12 @@ "readOnly": true, "type": "array" }, + "thoughtsTokenCount": { + "description": "Output only. Number of tokens present in thoughts output.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "toolUsePromptTokenCount": { "description": "Output only. Number of tokens present in tool-use prompt(s).", "format": "int32", @@ -28101,6 +28107,14 @@ "$ref": "GoogleCloudAiplatformV1GoogleDriveSource", "description": "Google Drive location. Supports importing individual files as well as Google Drive folders." }, + "importResultBigquerySink": { + "$ref": "GoogleCloudAiplatformV1BigQueryDestination", + "description": "The BigQuery destination to write import result to. It should be a bigquery table resource name (e.g. \"bq://projectId.bqDatasetId.bqTableId\"). The dataset must exist. If the table does not exist, it will be created with the expected schema. If the table exists, the schema will be validated and data will be added to this existing table." + }, + "importResultGcsSink": { + "$ref": "GoogleCloudAiplatformV1GcsDestination", + "description": "The Cloud Storage path to write import result to." + }, "jiraSource": { "$ref": "GoogleCloudAiplatformV1JiraSource", "description": "Jira queries with their corresponding authentication." @@ -28120,6 +28134,10 @@ "deprecated": true, "description": "The Cloud Storage path to write partial failures to. Deprecated. Prefer to use `import_result_gcs_sink`." }, + "ragFileParsingConfig": { + "$ref": "GoogleCloudAiplatformV1RagFileParsingConfig", + "description": "Optional. Specifies the parsing config for RagFiles. RAG will use the default parser if this field is not set." + }, "ragFileTransformationConfig": { "$ref": "GoogleCloudAiplatformV1RagFileTransformationConfig", "description": "Specifies the transformation config for RagFiles." @@ -29744,6 +29762,7 @@ "NVIDIA_L4", "NVIDIA_H100_80GB", "NVIDIA_H100_MEGA_80GB", + "NVIDIA_H200_141GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -29764,6 +29783,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -29778,6 +29798,7 @@ "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", "Nvidia H100 Mega 80Gb GPU.", + "Nvidia H200 141Gb GPU.", "TPU v2.", "TPU v3.", "TPU v4.", @@ -33917,7 +33938,7 @@ "type": "string" }, "postStartupScriptUrl": { - "description": "Optional. Post startup script url to download. Example: https://bucket/script.sh", + "description": "Optional. Post startup script url to download. Example: `gs://bucket/script.sh`", "type": "string" } }, @@ -35419,6 +35440,33 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1RagFileParsingConfig": { + "description": "Specifies the parsing config for RagFiles.", + "id": "GoogleCloudAiplatformV1RagFileParsingConfig", + "properties": { + "layoutParser": { + "$ref": "GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser", + "description": "The Layout Parser to use for RagFiles." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser": { + "description": "Document AI Layout Parser config.", + "id": "GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser", + "properties": { + "maxParsingRequestsPerMin": { + "description": "The maximum number of requests the job is allowed to make to the Document AI processor per minute. Consult https://cloud.google.com/document-ai/quotas and the Quota page for your project to set an appropriate value here. If unspecified, a default value of 120 QPM would be used.", + "format": "int32", + "type": "integer" + }, + "processorName": { + "description": "The full resource name of a Document AI processor or processor version. The processor must have type `LAYOUT_PARSER_PROCESSOR`. If specified, the `additional_config.parse_as_scanned_pdf` field must be false. Format: * `projects/{project_id}/locations/{location}/processors/{processor_id}` * `projects/{project_id}/locations/{location}/processors/{processor_id}/processorVersions/{processor_version_id}`", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1RagFileTransformationConfig": { "description": "Specifies the transformation config for RagFiles.", "id": "GoogleCloudAiplatformV1RagFileTransformationConfig", @@ -35852,6 +35900,10 @@ "description": "ReasoningEngine configurations", "id": "GoogleCloudAiplatformV1ReasoningEngineSpec", "properties": { + "agentFramework": { + "description": "Optional. The OSS agent framework used to develop the agent. Currently supported values: \"langchain\", \"langgraph\", \"ag2\", \"custom\".", + "type": "string" + }, "classMethods": { "description": "Optional. Declarations for object class methods in OpenAPI specification format.", "items": { @@ -35869,7 +35921,7 @@ }, "packageSpec": { "$ref": "GoogleCloudAiplatformV1ReasoningEngineSpecPackageSpec", - "description": "Required. User provided package spec of the ReasoningEngine." + "description": "Required. User provided package spec of the ReasoningEngine. Ignored when users directly specify a deployment image through `deployment_spec.first_party_image_override`, but keeping the field_behavior to avoid introducing breaking changes." } }, "type": "object" @@ -45056,6 +45108,10 @@ "datastore": { "description": "Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`", "type": "string" + }, + "engine": { + "description": "Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`", + "type": "string" } }, "type": "object" diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index 532889f2db..82001c50c8 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -7497,9 +7497,10 @@ type GoogleCloudAiplatformV1DirectUploadSource struct { type GoogleCloudAiplatformV1DiskSpec struct { // BootDiskSizeGb: Size in GB of the boot disk (default is 100GB). BootDiskSizeGb int64 `json:"bootDiskSizeGb,omitempty"` - // BootDiskType: Type of the boot disk (default is "pd-ssd"). Valid values: - // "pd-ssd" (Persistent Disk Solid State Drive) or "pd-standard" (Persistent - // Disk Hard Disk Drive). + // BootDiskType: Type of the boot disk. For non-A3U machines, the default value + // is "pd-ssd", for A3U machines, the default value is "hyperdisk-balanced". + // Valid values: "pd-ssd" (Persistent Disk Solid State Drive), "pd-standard" + // (Persistent Disk Hard Disk Drive) or "hyperdisk-balanced". BootDiskType string `json:"bootDiskType,omitempty"` // ForceSendFields is a list of field names (e.g. "BootDiskSizeGb") to // unconditionally include in API requests. By default, fields with empty or @@ -12622,6 +12623,9 @@ type GoogleCloudAiplatformV1GenerateContentResponseUsageMetadata struct { // PromptTokensDetails: Output only. List of modalities that were processed in // the request input. PromptTokensDetails []*GoogleCloudAiplatformV1ModalityTokenCount `json:"promptTokensDetails,omitempty"` + // ThoughtsTokenCount: Output only. Number of tokens present in thoughts + // output. + ThoughtsTokenCount int64 `json:"thoughtsTokenCount,omitempty"` // ToolUsePromptTokenCount: Output only. Number of tokens present in tool-use // prompt(s). ToolUsePromptTokenCount int64 `json:"toolUsePromptTokenCount,omitempty"` @@ -13699,6 +13703,15 @@ type GoogleCloudAiplatformV1ImportRagFilesConfig struct { // GoogleDriveSource: Google Drive location. Supports importing individual // files as well as Google Drive folders. GoogleDriveSource *GoogleCloudAiplatformV1GoogleDriveSource `json:"googleDriveSource,omitempty"` + // ImportResultBigquerySink: The BigQuery destination to write import result + // to. It should be a bigquery table resource name (e.g. + // "bq://projectId.bqDatasetId.bqTableId"). The dataset must exist. If the + // table does not exist, it will be created with the expected schema. If the + // table exists, the schema will be validated and data will be added to this + // existing table. + ImportResultBigquerySink *GoogleCloudAiplatformV1BigQueryDestination `json:"importResultBigquerySink,omitempty"` + // ImportResultGcsSink: The Cloud Storage path to write import result to. + ImportResultGcsSink *GoogleCloudAiplatformV1GcsDestination `json:"importResultGcsSink,omitempty"` // JiraSource: Jira queries with their corresponding authentication. JiraSource *GoogleCloudAiplatformV1JiraSource `json:"jiraSource,omitempty"` // MaxEmbeddingRequestsPerMin: Optional. The max number of queries per minute @@ -13717,6 +13730,9 @@ type GoogleCloudAiplatformV1ImportRagFilesConfig struct { // PartialFailureGcsSink: The Cloud Storage path to write partial failures to. // Deprecated. Prefer to use `import_result_gcs_sink`. PartialFailureGcsSink *GoogleCloudAiplatformV1GcsDestination `json:"partialFailureGcsSink,omitempty"` + // RagFileParsingConfig: Optional. Specifies the parsing config for RagFiles. + // RAG will use the default parser if this field is not set. + RagFileParsingConfig *GoogleCloudAiplatformV1RagFileParsingConfig `json:"ragFileParsingConfig,omitempty"` // RagFileTransformationConfig: Specifies the transformation config for // RagFiles. RagFileTransformationConfig *GoogleCloudAiplatformV1RagFileTransformationConfig `json:"ragFileTransformationConfig,omitempty"` @@ -16180,6 +16196,7 @@ type GoogleCloudAiplatformV1MachineSpec struct { // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 Mega 80Gb GPU. + // "NVIDIA_H200_141GB" - Nvidia H200 141Gb GPU. // "TPU_V2" - TPU v2. // "TPU_V3" - TPU v3. // "TPU_V4_POD" - TPU v4. @@ -21479,7 +21496,7 @@ type GoogleCloudAiplatformV1PostStartupScriptConfig struct { // every time runtime is started. PostStartupScriptBehavior string `json:"postStartupScriptBehavior,omitempty"` // PostStartupScriptUrl: Optional. Post startup script url to download. - // Example: https://bucket/script.sh + // Example: `gs://bucket/script.sh` PostStartupScriptUrl string `json:"postStartupScriptUrl,omitempty"` // ForceSendFields is a list of field names (e.g. "PostStartupScript") to // unconditionally include in API requests. By default, fields with empty or @@ -23648,6 +23665,64 @@ func (s GoogleCloudAiplatformV1RagFileChunkingConfigFixedLengthChunking) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1RagFileParsingConfig: Specifies the parsing config +// for RagFiles. +type GoogleCloudAiplatformV1RagFileParsingConfig struct { + // LayoutParser: The Layout Parser to use for RagFiles. + LayoutParser *GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser `json:"layoutParser,omitempty"` + // ForceSendFields is a list of field names (e.g. "LayoutParser") 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. "LayoutParser") 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 GoogleCloudAiplatformV1RagFileParsingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1RagFileParsingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser: Document AI Layout +// Parser config. +type GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser struct { + // MaxParsingRequestsPerMin: The maximum number of requests the job is allowed + // to make to the Document AI processor per minute. Consult + // https://cloud.google.com/document-ai/quotas and the Quota page for your + // project to set an appropriate value here. If unspecified, a default value of + // 120 QPM would be used. + MaxParsingRequestsPerMin int64 `json:"maxParsingRequestsPerMin,omitempty"` + // ProcessorName: The full resource name of a Document AI processor or + // processor version. The processor must have type `LAYOUT_PARSER_PROCESSOR`. + // If specified, the `additional_config.parse_as_scanned_pdf` field must be + // false. Format: * + // `projects/{project_id}/locations/{location}/processors/{processor_id}` * + // `projects/{project_id}/locations/{location}/processors/{processor_id}/process + // orVersions/{processor_version_id}` + ProcessorName string `json:"processorName,omitempty"` + // ForceSendFields is a list of field names (e.g. "MaxParsingRequestsPerMin") + // 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. "MaxParsingRequestsPerMin") 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 GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1RagFileParsingConfigLayoutParser + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1RagFileTransformationConfig: Specifies the // transformation config for RagFiles. type GoogleCloudAiplatformV1RagFileTransformationConfig struct { @@ -24388,6 +24463,9 @@ func (s GoogleCloudAiplatformV1ReasoningEngine) MarshalJSON() ([]byte, error) { // GoogleCloudAiplatformV1ReasoningEngineSpec: ReasoningEngine configurations type GoogleCloudAiplatformV1ReasoningEngineSpec struct { + // AgentFramework: Optional. The OSS agent framework used to develop the agent. + // Currently supported values: "langchain", "langgraph", "ag2", "custom". + AgentFramework string `json:"agentFramework,omitempty"` // ClassMethods: Optional. Declarations for object class methods in OpenAPI // specification format. ClassMethods []googleapi.RawMessage `json:"classMethods,omitempty"` @@ -24395,16 +24473,19 @@ type GoogleCloudAiplatformV1ReasoningEngineSpec struct { // deployment. DeploymentSpec *GoogleCloudAiplatformV1ReasoningEngineSpecDeploymentSpec `json:"deploymentSpec,omitempty"` // PackageSpec: Required. User provided package spec of the ReasoningEngine. + // Ignored when users directly specify a deployment image through + // `deployment_spec.first_party_image_override`, but keeping the field_behavior + // to avoid introducing breaking changes. PackageSpec *GoogleCloudAiplatformV1ReasoningEngineSpecPackageSpec `json:"packageSpec,omitempty"` - // ForceSendFields is a list of field names (e.g. "ClassMethods") to + // ForceSendFields is a list of field names (e.g. "AgentFramework") 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. "ClassMethods") 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. "AgentFramework") 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:"-"` } @@ -38520,6 +38601,11 @@ type GoogleCloudAiplatformV1VertexAISearch struct { // `projects/{project}/locations/{location}/collections/{collection}/dataStores/ // {dataStore}` Datastore string `json:"datastore,omitempty"` + // Engine: Optional. Fully-qualified Vertex AI Search engine resource ID. + // Format: + // `projects/{project}/locations/{location}/collections/{collection}/engines/{en + // gine}` + Engine string `json:"engine,omitempty"` // ForceSendFields is a list of field names (e.g. "Datastore") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/aiplatform/v1beta1/aiplatform-api.json b/aiplatform/v1beta1/aiplatform-api.json index 27682bf028..32f6b4db2c 100644 --- a/aiplatform/v1beta1/aiplatform-api.json +++ b/aiplatform/v1beta1/aiplatform-api.json @@ -985,7 +985,7 @@ ] }, "deploy": { - "description": "Deploys publisher models.", + "description": "Deploys a model to a new endpoint.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:deploy", "httpMethod": "POST", "id": "aiplatform.projects.locations.deploy", @@ -1002,6 +1002,35 @@ } }, "path": "v1beta1/{+destination}:deploy", + "request": { + "$ref": "GoogleCloudAiplatformV1beta1DeployRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "deployPublisherModel": { + "deprecated": true, + "description": "Deploys publisher models.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:deployPublisherModel", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.deployPublisherModel", + "parameterOrder": [ + "destination" + ], + "parameters": { + "destination": { + "description": "Required. The resource name of the Location to deploy the model in. Format: `projects/{project}/locations/{location}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+destination}:deployPublisherModel", "request": { "$ref": "GoogleCloudAiplatformV1beta1DeployPublisherModelRequest" }, @@ -2410,6 +2439,62 @@ }, "datasets": { "methods": { + "assemble": { + "description": "Assembles each row of a multimodal dataset and writes the result into a BigQuery table.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:assemble", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.datasets.assemble", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the Dataset resource (used only for MULTIMODAL datasets). Format: `projects/{project}/locations/{location}/datasets/{dataset}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:assemble", + "request": { + "$ref": "GoogleCloudAiplatformV1beta1AssembleDataRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "assess": { + "description": "Assesses the state or validity of the dataset with respect to a given use case.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:assess", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.datasets.assess", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the Dataset resource. Used only for MULTIMODAL datasets. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:assess", + "request": { + "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a Dataset.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets", @@ -21941,6 +22026,11 @@ "location": "query", "type": "string" }, + "includeEquivalentModelGardenModelDeploymentConfigs": { + "description": "Optional. Whether to cnclude the deployment configs from the equivalent Model Garden model if the requested model is a Hugging Face model.", + "location": "query", + "type": "boolean" + }, "isHuggingFaceModel": { "description": "Optional. Boolean indicates whether the requested model is a Hugging Face model.", "location": "query", @@ -22120,7 +22210,7 @@ } } }, - "revision": "20250226", + "revision": "20250307", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -22867,6 +22957,72 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1AssembleDataRequest": { + "description": "Request message for DatasetService.AssembleData. Used only for MULTIMODAL datasets.", + "id": "GoogleCloudAiplatformV1beta1AssembleDataRequest", + "properties": { + "geminiTemplateConfig": { + "$ref": "GoogleCloudAiplatformV1beta1GeminiTemplateConfig", + "description": "Optional. Config for assembling templates with a Gemini API structure." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1AssessDataRequest": { + "description": "Request message for DatasetService.AssessData. Used only for MULTIMODAL datasets.", + "id": "GoogleCloudAiplatformV1beta1AssessDataRequest", + "properties": { + "geminiTemplateConfig": { + "$ref": "GoogleCloudAiplatformV1beta1GeminiTemplateConfig", + "description": "Optional. Config for assembling templates with a Gemini API structure to assess assembled data." + }, + "tuningResourceUsageAssessmentConfig": { + "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig", + "description": "Optional. Configuration for the tuning resource usage assessment." + }, + "tuningValidationAssessmentConfig": { + "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig", + "description": "Optional. Configuration for the tuning validation assessment." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig": { + "description": "Configuration for the tuning resource usage assessment.", + "id": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig", + "properties": { + "modelName": { + "description": "Required. The name of the model used for tuning.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig": { + "description": "Configuration for the tuning validation assessment.", + "id": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig", + "properties": { + "datasetUsage": { + "description": "Required. The dataset usage (e.g. training/validation).", + "enum": [ + "DATASET_USAGE_UNSPECIFIED", + "SFT_TRAINING", + "SFT_VALIDATION" + ], + "enumDescriptions": [ + "Default value. Should not be used.", + "Supervised fine-tuning training dataset.", + "Supervised fine-tuning validation dataset." + ], + "type": "string" + }, + "modelName": { + "description": "Required. The name of the model used for tuning.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeOperationMetadata": { "description": "Metadata information for NotebookService.AssignNotebookRuntime.", "id": "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeOperationMetadata", @@ -23070,7 +23226,7 @@ "type": "string" }, "httpElementLocation": { - "description": "Required. The location of the API key.", + "description": "Optional. The location of the API key.", "enum": [ "HTTP_IN_UNSPECIFIED", "HTTP_IN_QUERY", @@ -23090,7 +23246,7 @@ "type": "string" }, "name": { - "description": "Required. The parameter name of the API key. E.g. If the API request is \"https://example.com/act?api_key=\", \"api_key\" would be the parameter name.", + "description": "Optional. The parameter name of the API key. E.g. If the API request is \"https://example.com/act?api_key=\", \"api_key\" would be the parameter name.", "type": "string" } }, @@ -26304,6 +26460,7 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1DeployPublisherModelRequest": { + "deprecated": true, "description": "Request message for ModelGardenService.DeployPublisherModel.", "id": "GoogleCloudAiplatformV1beta1DeployPublisherModelRequest", "properties": { @@ -26324,7 +26481,7 @@ "type": "string" }, "model": { - "description": "Required. The model to deploy. Format: 1. `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`. 2. Hugging Face model ID like `google/gemma-2-2b-it`. 3. Custom model Google Cloud Storage URI like `gs://bucket`. 4. Custom model zip file like `https://abc.com/a.zip`.", + "description": "Required. The model to deploy. Format: 1. `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`. 2. Hugging Face model ID like `google/gemma-2-2b-it`. 3. Custom model Google Cloud Storage URI like `gs://bucket`. 4. Custom model zip file like `https://example.com/a.zip`.", "type": "string" }, "modelDisplayName": { @@ -26818,7 +26975,7 @@ "type": "integer" }, "bootDiskType": { - "description": "Type of the boot disk (default is \"pd-ssd\"). Valid values: \"pd-ssd\" (Persistent Disk Solid State Drive) or \"pd-standard\" (Persistent Disk Hard Disk Drive).", + "description": "Type of the boot disk. For non-A3U machines, the default value is \"pd-ssd\", for A3U machines, the default value is \"hyperdisk-balanced\". Valid values: \"pd-ssd\" (Persistent Disk Solid State Drive), \"pd-standard\" (Persistent Disk Hard Disk Drive) or \"hyperdisk-balanced\".", "type": "string" } }, @@ -30870,6 +31027,79 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1GeminiExample": { + "description": "Format for Gemini examples used for Vertex Multimodal datasets.", + "id": "GoogleCloudAiplatformV1beta1GeminiExample", + "properties": { + "cachedContent": { + "description": "Optional. The name of the cached content used as context to serve the prediction. Note: only used in explicit caching, where users can have control over caching (e.g. what content to cache) and enjoy guaranteed cost savings. Format: `projects/{project}/locations/{location}/cachedContents/{cachedContent}`", + "type": "string" + }, + "contents": { + "description": "Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1Content" + }, + "type": "array" + }, + "generationConfig": { + "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig", + "description": "Optional. Generation config." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", + "type": "object" + }, + "model": { + "description": "Optional. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", + "type": "string" + }, + "safetySettings": { + "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1SafetySetting" + }, + "type": "array" + }, + "systemInstruction": { + "$ref": "GoogleCloudAiplatformV1beta1Content", + "description": "Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph." + }, + "toolConfig": { + "$ref": "GoogleCloudAiplatformV1beta1ToolConfig", + "description": "Optional. Tool config. This config is shared for all tools provided in the request." + }, + "tools": { + "description": "Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1Tool" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1GeminiTemplateConfig": { + "description": "Template configuration to create Gemini examples from a multimodal dataset.", + "id": "GoogleCloudAiplatformV1beta1GeminiTemplateConfig", + "properties": { + "fieldMapping": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. Map of template params to the columns in the dataset table.", + "type": "object" + }, + "geminiExample": { + "$ref": "GoogleCloudAiplatformV1beta1GeminiExample", + "description": "Required. The template that will be used for assembling the request to use for downstream applications." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig": { "description": "Configuration for GenAiAdvancedFeatures.", "id": "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig", @@ -31101,6 +31331,12 @@ "readOnly": true, "type": "array" }, + "thoughtsTokenCount": { + "description": "Output only. Number of tokens present in thoughts output.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "toolUsePromptTokenCount": { "description": "Output only. Number of tokens present in tool-use prompt(s).", "format": "int32", @@ -31992,6 +32228,14 @@ "$ref": "GoogleCloudAiplatformV1beta1GoogleDriveSource", "description": "Google Drive location. Supports importing individual files as well as Google Drive folders." }, + "importResultBigquerySink": { + "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination", + "description": "The BigQuery destination to write import result to. It should be a bigquery table resource name (e.g. \"bq://projectId.bqDatasetId.bqTableId\"). The dataset must exist. If the table does not exist, it will be created with the expected schema. If the table exists, the schema will be validated and data will be added to this existing table." + }, + "importResultGcsSink": { + "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", + "description": "The Cloud Storage path to write import result to." + }, "jiraSource": { "$ref": "GoogleCloudAiplatformV1beta1JiraSource", "description": "Jira queries with their corresponding authentication." @@ -33805,6 +34049,7 @@ "NVIDIA_L4", "NVIDIA_H100_80GB", "NVIDIA_H100_MEGA_80GB", + "NVIDIA_H200_141GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -33825,6 +34070,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -33839,6 +34085,7 @@ "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", "Nvidia H100 Mega 80Gb GPU.", + "Nvidia H200 141Gb GPU.", "TPU v2.", "TPU v3.", "TPU v4.", @@ -38915,7 +39162,7 @@ "type": "string" }, "postStartupScriptUrl": { - "description": "Optional. Post startup script url to download. Example: https://bucket/script.sh", + "description": "Optional. Post startup script url to download. Example: `gs://bucket/script.sh`", "type": "string" } }, @@ -41241,6 +41488,10 @@ "description": "ReasoningEngine configurations", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpec", "properties": { + "agentFramework": { + "description": "Optional. The OSS agent framework used to develop the agent. Currently supported values: \"langchain\", \"langgraph\", \"ag2\", \"custom\".", + "type": "string" + }, "classMethods": { "description": "Optional. Declarations for object class methods in OpenAPI specification format.", "items": { @@ -41258,7 +41509,7 @@ }, "packageSpec": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecPackageSpec", - "description": "Required. User provided package spec of the ReasoningEngine." + "description": "Required. User provided package spec of the ReasoningEngine. Ignored when users directly specify a deployment image through `deployment_spec.first_party_image_override`, but keeping the field_behavior to avoid introducing breaking changes." } }, "type": "object" @@ -51048,6 +51299,10 @@ "datastore": { "description": "Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`", "type": "string" + }, + "engine": { + "description": "Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`", + "type": "string" } }, "type": "object" diff --git a/aiplatform/v1beta1/aiplatform-gen.go b/aiplatform/v1beta1/aiplatform-gen.go index 81270fa68f..83632b6a20 100644 --- a/aiplatform/v1beta1/aiplatform-gen.go +++ b/aiplatform/v1beta1/aiplatform-gen.go @@ -2695,6 +2695,113 @@ func (s GoogleCloudAiplatformV1beta1ArtifactTypeSchema) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1AssembleDataRequest: Request message for +// DatasetService.AssembleData. Used only for MULTIMODAL datasets. +type GoogleCloudAiplatformV1beta1AssembleDataRequest struct { + // GeminiTemplateConfig: Optional. Config for assembling templates with a + // Gemini API structure. + GeminiTemplateConfig *GoogleCloudAiplatformV1beta1GeminiTemplateConfig `json:"geminiTemplateConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "GeminiTemplateConfig") 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. "GeminiTemplateConfig") 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 GoogleCloudAiplatformV1beta1AssembleDataRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1AssembleDataRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1AssessDataRequest: Request message for +// DatasetService.AssessData. Used only for MULTIMODAL datasets. +type GoogleCloudAiplatformV1beta1AssessDataRequest struct { + // GeminiTemplateConfig: Optional. Config for assembling templates with a + // Gemini API structure to assess assembled data. + GeminiTemplateConfig *GoogleCloudAiplatformV1beta1GeminiTemplateConfig `json:"geminiTemplateConfig,omitempty"` + // TuningResourceUsageAssessmentConfig: Optional. Configuration for the tuning + // resource usage assessment. + TuningResourceUsageAssessmentConfig *GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig `json:"tuningResourceUsageAssessmentConfig,omitempty"` + // TuningValidationAssessmentConfig: Optional. Configuration for the tuning + // validation assessment. + TuningValidationAssessmentConfig *GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig `json:"tuningValidationAssessmentConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "GeminiTemplateConfig") 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. "GeminiTemplateConfig") 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 GoogleCloudAiplatformV1beta1AssessDataRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1AssessDataRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentCon +// fig: Configuration for the tuning resource usage assessment. +type GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig struct { + // ModelName: Required. The name of the model used for tuning. + ModelName string `json:"modelName,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelName") 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. "ModelName") 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 GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig +// : Configuration for the tuning validation assessment. +type GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig struct { + // DatasetUsage: Required. The dataset usage (e.g. training/validation). + // + // Possible values: + // "DATASET_USAGE_UNSPECIFIED" - Default value. Should not be used. + // "SFT_TRAINING" - Supervised fine-tuning training dataset. + // "SFT_VALIDATION" - Supervised fine-tuning validation dataset. + DatasetUsage string `json:"datasetUsage,omitempty"` + // ModelName: Required. The name of the model used for tuning. + ModelName string `json:"modelName,omitempty"` + // ForceSendFields is a list of field names (e.g. "DatasetUsage") 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. "DatasetUsage") 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 GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1AssignNotebookRuntimeOperationMetadata: Metadata // information for NotebookService.AssignNotebookRuntime. type GoogleCloudAiplatformV1beta1AssignNotebookRuntimeOperationMetadata struct { @@ -2985,7 +3092,7 @@ type GoogleCloudAiplatformV1beta1AuthConfigApiKeyConfig struct { ApiKeySecret string `json:"apiKeySecret,omitempty"` // ApiKeyString: Optional. The API key to be used in the request directly. ApiKeyString string `json:"apiKeyString,omitempty"` - // HttpElementLocation: Required. The location of the API key. + // HttpElementLocation: Optional. The location of the API key. // // Possible values: // "HTTP_IN_UNSPECIFIED" @@ -2995,7 +3102,7 @@ type GoogleCloudAiplatformV1beta1AuthConfigApiKeyConfig struct { // "HTTP_IN_BODY" - Element is in the HTTP request body. // "HTTP_IN_COOKIE" - Element is in the HTTP request cookie. HttpElementLocation string `json:"httpElementLocation,omitempty"` - // Name: Required. The parameter name of the API key. E.g. If the API request + // Name: Optional. The parameter name of the API key. E.g. If the API request // is "https://example.com/act?api_key=", "api_key" would be the parameter // name. Name string `json:"name,omitempty"` @@ -7810,7 +7917,7 @@ type GoogleCloudAiplatformV1beta1DeployPublisherModelRequest struct { // `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`. // 2. Hugging Face model ID like `google/gemma-2-2b-it`. 3. Custom model Google // Cloud Storage URI like `gs://bucket`. 4. Custom model zip file like - // `https://abc.com/a.zip`. + // `https://example.com/a.zip`. Model string `json:"model,omitempty"` // ModelDisplayName: Optional. The user-specified display name of the uploaded // model. If not set, a default name will be used. @@ -8523,9 +8630,10 @@ type GoogleCloudAiplatformV1beta1DirectUploadSource struct { type GoogleCloudAiplatformV1beta1DiskSpec struct { // BootDiskSizeGb: Size in GB of the boot disk (default is 100GB). BootDiskSizeGb int64 `json:"bootDiskSizeGb,omitempty"` - // BootDiskType: Type of the boot disk (default is "pd-ssd"). Valid values: - // "pd-ssd" (Persistent Disk Solid State Drive) or "pd-standard" (Persistent - // Disk Hard Disk Drive). + // BootDiskType: Type of the boot disk. For non-A3U machines, the default value + // is "pd-ssd", for A3U machines, the default value is "hyperdisk-balanced". + // Valid values: "pd-ssd" (Persistent Disk Solid State Drive), "pd-standard" + // (Persistent Disk Hard Disk Drive) or "hyperdisk-balanced". BootDiskType string `json:"bootDiskType,omitempty"` // ForceSendFields is a list of field names (e.g. "BootDiskSizeGb") to // unconditionally include in API requests. By default, fields with empty or @@ -14270,6 +14378,95 @@ func (s GoogleCloudAiplatformV1beta1GcsSource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1GeminiExample: Format for Gemini examples used +// for Vertex Multimodal datasets. +type GoogleCloudAiplatformV1beta1GeminiExample struct { + // CachedContent: Optional. The name of the cached content used as context to + // serve the prediction. Note: only used in explicit caching, where users can + // have control over caching (e.g. what content to cache) and enjoy guaranteed + // cost savings. Format: + // `projects/{project}/locations/{location}/cachedContents/{cachedContent}` + CachedContent string `json:"cachedContent,omitempty"` + // Contents: Required. The content of the current conversation with the model. + // For single-turn queries, this is a single instance. For multi-turn queries, + // this is a repeated field that contains conversation history + latest + // request. + Contents []*GoogleCloudAiplatformV1beta1Content `json:"contents,omitempty"` + // GenerationConfig: Optional. Generation config. + GenerationConfig *GoogleCloudAiplatformV1beta1GenerationConfig `json:"generationConfig,omitempty"` + // Labels: Optional. The labels with user-defined metadata for the request. It + // is used for billing and reporting only. Label keys and values can be no + // longer than 63 characters (Unicode codepoints) and can only contain + // lowercase letters, numeric characters, underscores, and dashes. + // International characters are allowed. Label values are optional. Label keys + // must start with a letter. + Labels map[string]string `json:"labels,omitempty"` + // Model: Optional. The fully qualified name of the publisher model or tuned + // model endpoint to use. Publisher model format: + // `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model + // endpoint format: + // `projects/{project}/locations/{location}/endpoints/{endpoint}` + Model string `json:"model,omitempty"` + // SafetySettings: Optional. Per request settings for blocking unsafe content. + // Enforced on GenerateContentResponse.candidates. + SafetySettings []*GoogleCloudAiplatformV1beta1SafetySetting `json:"safetySettings,omitempty"` + // SystemInstruction: Optional. The user provided system instructions for the + // model. Note: only text should be used in parts and content in each part will + // be in a separate paragraph. + SystemInstruction *GoogleCloudAiplatformV1beta1Content `json:"systemInstruction,omitempty"` + // ToolConfig: Optional. Tool config. This config is shared for all tools + // provided in the request. + ToolConfig *GoogleCloudAiplatformV1beta1ToolConfig `json:"toolConfig,omitempty"` + // Tools: Optional. A list of `Tools` the model may use to generate the next + // response. A `Tool` is a piece of code that enables the system to interact + // with external systems to perform an action, or set of actions, outside of + // knowledge and scope of the model. + Tools []*GoogleCloudAiplatformV1beta1Tool `json:"tools,omitempty"` + // ForceSendFields is a list of field names (e.g. "CachedContent") 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. "CachedContent") 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 GoogleCloudAiplatformV1beta1GeminiExample) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1GeminiExample + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1GeminiTemplateConfig: Template configuration to +// create Gemini examples from a multimodal dataset. +type GoogleCloudAiplatformV1beta1GeminiTemplateConfig struct { + // FieldMapping: Required. Map of template params to the columns in the dataset + // table. + FieldMapping map[string]string `json:"fieldMapping,omitempty"` + // GeminiExample: Required. The template that will be used for assembling the + // request to use for downstream applications. + GeminiExample *GoogleCloudAiplatformV1beta1GeminiExample `json:"geminiExample,omitempty"` + // ForceSendFields is a list of field names (e.g. "FieldMapping") 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. "FieldMapping") 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 GoogleCloudAiplatformV1beta1GeminiTemplateConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1GeminiTemplateConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig: Configuration for // GenAiAdvancedFeatures. type GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig struct { @@ -14530,6 +14727,9 @@ type GoogleCloudAiplatformV1beta1GenerateContentResponseUsageMetadata struct { // PromptTokensDetails: Output only. List of modalities that were processed in // the request input. PromptTokensDetails []*GoogleCloudAiplatformV1beta1ModalityTokenCount `json:"promptTokensDetails,omitempty"` + // ThoughtsTokenCount: Output only. Number of tokens present in thoughts + // output. + ThoughtsTokenCount int64 `json:"thoughtsTokenCount,omitempty"` // ToolUsePromptTokenCount: Output only. Number of tokens present in tool-use // prompt(s). ToolUsePromptTokenCount int64 `json:"toolUsePromptTokenCount,omitempty"` @@ -15636,6 +15836,15 @@ type GoogleCloudAiplatformV1beta1ImportRagFilesConfig struct { // GoogleDriveSource: Google Drive location. Supports importing individual // files as well as Google Drive folders. GoogleDriveSource *GoogleCloudAiplatformV1beta1GoogleDriveSource `json:"googleDriveSource,omitempty"` + // ImportResultBigquerySink: The BigQuery destination to write import result + // to. It should be a bigquery table resource name (e.g. + // "bq://projectId.bqDatasetId.bqTableId"). The dataset must exist. If the + // table does not exist, it will be created with the expected schema. If the + // table exists, the schema will be validated and data will be added to this + // existing table. + ImportResultBigquerySink *GoogleCloudAiplatformV1beta1BigQueryDestination `json:"importResultBigquerySink,omitempty"` + // ImportResultGcsSink: The Cloud Storage path to write import result to. + ImportResultGcsSink *GoogleCloudAiplatformV1beta1GcsDestination `json:"importResultGcsSink,omitempty"` // JiraSource: Jira queries with their corresponding authentication. JiraSource *GoogleCloudAiplatformV1beta1JiraSource `json:"jiraSource,omitempty"` // MaxEmbeddingRequestsPerMin: Optional. The max number of queries per minute @@ -18350,6 +18559,7 @@ type GoogleCloudAiplatformV1beta1MachineSpec struct { // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 Mega 80Gb GPU. + // "NVIDIA_H200_141GB" - Nvidia H200 141Gb GPU. // "TPU_V2" - TPU v2. // "TPU_V3" - TPU v3. // "TPU_V4_POD" - TPU v4. @@ -25007,7 +25217,7 @@ type GoogleCloudAiplatformV1beta1PostStartupScriptConfig struct { // every time runtime is started. PostStartupScriptBehavior string `json:"postStartupScriptBehavior,omitempty"` // PostStartupScriptUrl: Optional. Post startup script url to download. - // Example: https://bucket/script.sh + // Example: `gs://bucket/script.sh` PostStartupScriptUrl string `json:"postStartupScriptUrl,omitempty"` // ForceSendFields is a list of field names (e.g. "PostStartupScript") to // unconditionally include in API requests. By default, fields with empty or @@ -28544,6 +28754,9 @@ func (s GoogleCloudAiplatformV1beta1ReasoningEngine) MarshalJSON() ([]byte, erro // GoogleCloudAiplatformV1beta1ReasoningEngineSpec: ReasoningEngine // configurations type GoogleCloudAiplatformV1beta1ReasoningEngineSpec struct { + // AgentFramework: Optional. The OSS agent framework used to develop the agent. + // Currently supported values: "langchain", "langgraph", "ag2", "custom". + AgentFramework string `json:"agentFramework,omitempty"` // ClassMethods: Optional. Declarations for object class methods in OpenAPI // specification format. ClassMethods []googleapi.RawMessage `json:"classMethods,omitempty"` @@ -28551,16 +28764,19 @@ type GoogleCloudAiplatformV1beta1ReasoningEngineSpec struct { // deployment. DeploymentSpec *GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec `json:"deploymentSpec,omitempty"` // PackageSpec: Required. User provided package spec of the ReasoningEngine. + // Ignored when users directly specify a deployment image through + // `deployment_spec.first_party_image_override`, but keeping the field_behavior + // to avoid introducing breaking changes. PackageSpec *GoogleCloudAiplatformV1beta1ReasoningEngineSpecPackageSpec `json:"packageSpec,omitempty"` - // ForceSendFields is a list of field names (e.g. "ClassMethods") to + // ForceSendFields is a list of field names (e.g. "AgentFramework") 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. "ClassMethods") 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. "AgentFramework") 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:"-"` } @@ -43468,6 +43684,11 @@ type GoogleCloudAiplatformV1beta1VertexAISearch struct { // `projects/{project}/locations/{location}/collections/{collection}/dataStores/ // {dataStore}` Datastore string `json:"datastore,omitempty"` + // Engine: Optional. Fully-qualified Vertex AI Search engine resource ID. + // Format: + // `projects/{project}/locations/{location}/collections/{collection}/engines/{en + // gine}` + Engine string `json:"engine,omitempty"` // ForceSendFields is a list of field names (e.g. "Datastore") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -47107,22 +47328,22 @@ func (c *ProjectsLocationsCorroborateContentCall) Do(opts ...googleapi.CallOptio } type ProjectsLocationsDeployCall struct { - s *Service - destination string - googlecloudaiplatformv1beta1deploypublishermodelrequest *GoogleCloudAiplatformV1beta1DeployPublisherModelRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header + s *Service + destination string + googlecloudaiplatformv1beta1deployrequest *GoogleCloudAiplatformV1beta1DeployRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Deploy: Deploys publisher models. +// Deploy: Deploys a model to a new endpoint. // // - destination: The resource name of the Location to deploy the model in. // Format: `projects/{project}/locations/{location}`. -func (r *ProjectsLocationsService) Deploy(destination string, googlecloudaiplatformv1beta1deploypublishermodelrequest *GoogleCloudAiplatformV1beta1DeployPublisherModelRequest) *ProjectsLocationsDeployCall { +func (r *ProjectsLocationsService) Deploy(destination string, googlecloudaiplatformv1beta1deployrequest *GoogleCloudAiplatformV1beta1DeployRequest) *ProjectsLocationsDeployCall { c := &ProjectsLocationsDeployCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.destination = destination - c.googlecloudaiplatformv1beta1deploypublishermodelrequest = googlecloudaiplatformv1beta1deploypublishermodelrequest + c.googlecloudaiplatformv1beta1deployrequest = googlecloudaiplatformv1beta1deployrequest return c } @@ -47151,7 +47372,7 @@ func (c *ProjectsLocationsDeployCall) Header() http.Header { func (c *ProjectsLocationsDeployCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1beta1deploypublishermodelrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1beta1deployrequest) if err != nil { return nil, err } @@ -47211,6 +47432,111 @@ func (c *ProjectsLocationsDeployCall) Do(opts ...googleapi.CallOption) (*GoogleL return ret, nil } +type ProjectsLocationsDeployPublisherModelCall struct { + s *Service + destination string + googlecloudaiplatformv1beta1deploypublishermodelrequest *GoogleCloudAiplatformV1beta1DeployPublisherModelRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// DeployPublisherModel: Deploys publisher models. +// +// - destination: The resource name of the Location to deploy the model in. +// Format: `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) DeployPublisherModel(destination string, googlecloudaiplatformv1beta1deploypublishermodelrequest *GoogleCloudAiplatformV1beta1DeployPublisherModelRequest) *ProjectsLocationsDeployPublisherModelCall { + c := &ProjectsLocationsDeployPublisherModelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.destination = destination + c.googlecloudaiplatformv1beta1deploypublishermodelrequest = googlecloudaiplatformv1beta1deploypublishermodelrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsDeployPublisherModelCall) Fields(s ...googleapi.Field) *ProjectsLocationsDeployPublisherModelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDeployPublisherModelCall) Context(ctx context.Context) *ProjectsLocationsDeployPublisherModelCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsDeployPublisherModelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDeployPublisherModelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1beta1deploypublishermodelrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+destination}:deployPublisherModel") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "destination": c.destination, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.deployPublisherModel", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "aiplatform.projects.locations.deployPublisherModel" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsDeployPublisherModelCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.deployPublisherModel", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsEvaluateDatasetCall struct { s *Service location string @@ -52518,6 +52844,219 @@ func (c *ProjectsLocationsDataLabelingJobsOperationsWaitCall) Do(opts ...googlea return ret, nil } +type ProjectsLocationsDatasetsAssembleCall struct { + s *Service + name string + googlecloudaiplatformv1beta1assembledatarequest *GoogleCloudAiplatformV1beta1AssembleDataRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Assemble: Assembles each row of a multimodal dataset and writes the result +// into a BigQuery table. +// +// - name: The name of the Dataset resource (used only for MULTIMODAL +// datasets). Format: +// `projects/{project}/locations/{location}/datasets/{dataset}`. +func (r *ProjectsLocationsDatasetsService) Assemble(name string, googlecloudaiplatformv1beta1assembledatarequest *GoogleCloudAiplatformV1beta1AssembleDataRequest) *ProjectsLocationsDatasetsAssembleCall { + c := &ProjectsLocationsDatasetsAssembleCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudaiplatformv1beta1assembledatarequest = googlecloudaiplatformv1beta1assembledatarequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsDatasetsAssembleCall) Fields(s ...googleapi.Field) *ProjectsLocationsDatasetsAssembleCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDatasetsAssembleCall) Context(ctx context.Context) *ProjectsLocationsDatasetsAssembleCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsDatasetsAssembleCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDatasetsAssembleCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1beta1assembledatarequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:assemble") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.datasets.assemble", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "aiplatform.projects.locations.datasets.assemble" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsDatasetsAssembleCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.datasets.assemble", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsDatasetsAssessCall struct { + s *Service + name string + googlecloudaiplatformv1beta1assessdatarequest *GoogleCloudAiplatformV1beta1AssessDataRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Assess: Assesses the state or validity of the dataset with respect to a +// given use case. +// +// - name: The name of the Dataset resource. Used only for MULTIMODAL datasets. +// Format: `projects/{project}/locations/{location}/datasets/{dataset}`. +func (r *ProjectsLocationsDatasetsService) Assess(name string, googlecloudaiplatformv1beta1assessdatarequest *GoogleCloudAiplatformV1beta1AssessDataRequest) *ProjectsLocationsDatasetsAssessCall { + c := &ProjectsLocationsDatasetsAssessCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudaiplatformv1beta1assessdatarequest = googlecloudaiplatformv1beta1assessdatarequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsDatasetsAssessCall) Fields(s ...googleapi.Field) *ProjectsLocationsDatasetsAssessCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDatasetsAssessCall) Context(ctx context.Context) *ProjectsLocationsDatasetsAssessCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsDatasetsAssessCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDatasetsAssessCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1beta1assessdatarequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:assess") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.datasets.assess", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "aiplatform.projects.locations.datasets.assess" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsDatasetsAssessCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.datasets.assess", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsDatasetsCreateCall struct { s *Service parent string @@ -125716,6 +126255,15 @@ func (c *PublishersModelsGetCall) HuggingFaceToken(huggingFaceToken string) *Pub return c } +// IncludeEquivalentModelGardenModelDeploymentConfigs sets the optional +// parameter "includeEquivalentModelGardenModelDeploymentConfigs": Whether to +// cnclude the deployment configs from the equivalent Model Garden model if the +// requested model is a Hugging Face model. +func (c *PublishersModelsGetCall) IncludeEquivalentModelGardenModelDeploymentConfigs(includeEquivalentModelGardenModelDeploymentConfigs bool) *PublishersModelsGetCall { + c.urlParams_.Set("includeEquivalentModelGardenModelDeploymentConfigs", fmt.Sprint(includeEquivalentModelGardenModelDeploymentConfigs)) + return c +} + // IsHuggingFaceModel sets the optional parameter "isHuggingFaceModel": Boolean // indicates whether the requested model is a Hugging Face model. func (c *PublishersModelsGetCall) IsHuggingFaceModel(isHuggingFaceModel bool) *PublishersModelsGetCall { diff --git a/alloydb/v1/alloydb-api.json b/alloydb/v1/alloydb-api.json index 48cc1999db..6050819613 100644 --- a/alloydb/v1/alloydb-api.json +++ b/alloydb/v1/alloydb-api.json @@ -1616,7 +1616,7 @@ } } }, - "revision": "20250227", + "revision": "20250308", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2428,6 +2428,25 @@ }, "type": "object" }, + "DenyMaintenancePeriod": { + "description": "DenyMaintenancePeriod definition. Excepting emergencies, maintenance will not be scheduled to start within this deny period. The start_date must be less than the end_date.", + "id": "DenyMaintenancePeriod", + "properties": { + "endDate": { + "$ref": "GoogleTypeDate", + "description": "Deny period end date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring" + }, + "startDate": { + "$ref": "GoogleTypeDate", + "description": "Deny period start date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring" + }, + "time": { + "$ref": "GoogleTypeTimeOfDay", + "description": "Time in UTC when the deny period starts on start_date and ends on end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -2587,6 +2606,28 @@ }, "type": "object" }, + "GoogleTypeDate": { + "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", + "id": "GoogleTypeDate", + "properties": { + "day": { + "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", + "format": "int32", + "type": "integer" + }, + "month": { + "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", + "format": "int32", + "type": "integer" + }, + "year": { + "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "GoogleTypeTimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "GoogleTypeTimeOfDay", @@ -2892,6 +2933,11 @@ "enablePublicIp": { "description": "Optional. Enabling public ip for the instance.", "type": "boolean" + }, + "network": { + "description": "Output only. The resource link for the VPC network in which instance resources are created and from which they are accessible via Private IP. This will be the same value as the parent cluster's network. It is specified in the form: // `projects/{project_number}/global/networks/{network_id}`.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -3108,6 +3154,10 @@ "description": "The number of CPU's in the VM instance.", "format": "int32", "type": "integer" + }, + "machineType": { + "description": "Machine type of the VM instance. E.g. \"n2-highmem-4\", \"n2-highmem-8\", \"c4a-highmem-4-lssd\". cpu_count must match the number of vCPUs in the machine type.", + "type": "string" } }, "type": "object" @@ -3129,6 +3179,13 @@ "description": "MaintenanceUpdatePolicy defines the policy for system updates.", "id": "MaintenanceUpdatePolicy", "properties": { + "denyMaintenancePeriods": { + "description": "Periods to deny maintenance. Currently limited to 1.", + "items": { + "$ref": "DenyMaintenancePeriod" + }, + "type": "array" + }, "maintenanceWindows": { "description": "Preferred windows to perform maintenance. Currently limited to 1.", "items": { @@ -4281,7 +4338,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -4371,6 +4430,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -4461,7 +4522,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" }, @@ -4870,7 +4933,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -4960,6 +5025,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -5050,7 +5117,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" } diff --git a/alloydb/v1/alloydb-gen.go b/alloydb/v1/alloydb-gen.go index 647869ea4f..03bc8d99bf 100644 --- a/alloydb/v1/alloydb-gen.go +++ b/alloydb/v1/alloydb-gen.go @@ -1003,6 +1003,39 @@ func (s CsvImportOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DenyMaintenancePeriod: DenyMaintenancePeriod definition. Excepting +// emergencies, maintenance will not be scheduled to start within this deny +// period. The start_date must be less than the end_date. +type DenyMaintenancePeriod struct { + // EndDate: Deny period end date. This can be: * A full date, with non-zero + // year, month and day values OR * A month and day value, with a zero year for + // recurring + EndDate *GoogleTypeDate `json:"endDate,omitempty"` + // StartDate: Deny period start date. This can be: * A full date, with non-zero + // year, month and day values OR * A month and day value, with a zero year for + // recurring + StartDate *GoogleTypeDate `json:"startDate,omitempty"` + // Time: Time in UTC when the deny period starts on start_date and ends on + // end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC + Time *GoogleTypeTimeOfDay `json:"time,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndDate") 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. "EndDate") 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 DenyMaintenancePeriod) MarshalJSON() ([]byte, error) { + type NoMethod DenyMaintenancePeriod + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -1255,6 +1288,44 @@ func (s GoogleCloudLocationLocation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleTypeDate: Represents a whole or partial calendar date, such as a +// birthday. The time of day and time zone are either specified elsewhere or +// are insignificant. The date is relative to the Gregorian Calendar. This can +// represent one of the following: * A full date, with non-zero year, month, +// and day values. * A month and day, with a zero year (for example, an +// anniversary). * A year on its own, with a zero month and a zero day. * A +// year and month, with a zero day (for example, a credit card expiration +// date). Related types: * google.type.TimeOfDay * google.type.DateTime * +// google.protobuf.Timestamp +type GoogleTypeDate struct { + // Day: Day of a month. Must be from 1 to 31 and valid for the year and month, + // or 0 to specify a year by itself or a year and month where the day isn't + // significant. + Day int64 `json:"day,omitempty"` + // Month: Month of a year. Must be from 1 to 12, or 0 to specify a year without + // a month and day. + Month int64 `json:"month,omitempty"` + // Year: Year of the date. Must be from 1 to 9999, or 0 to specify a date + // without a year. + Year int64 `json:"year,omitempty"` + // ForceSendFields is a list of field names (e.g. "Day") 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. "Day") 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 GoogleTypeDate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeDate + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleTypeTimeOfDay: Represents a time of day. The date and time zone are // either not significant or are specified elsewhere. An API may choose to // allow leap seconds. Related types are google.type.Date and @@ -1562,6 +1633,12 @@ type InstanceNetworkConfig struct { EnableOutboundPublicIp bool `json:"enableOutboundPublicIp,omitempty"` // EnablePublicIp: Optional. Enabling public ip for the instance. EnablePublicIp bool `json:"enablePublicIp,omitempty"` + // Network: Output only. The resource link for the VPC network in which + // instance resources are created and from which they are accessible via + // Private IP. This will be the same value as the parent cluster's network. It + // is specified in the form: // + // `projects/{project_number}/global/networks/{network_id}`. + Network string `json:"network,omitempty"` // ForceSendFields is a list of field names (e.g. "AuthorizedExternalNetworks") // to unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1833,6 +1910,10 @@ func (s ListUsersResponse) MarshalJSON() ([]byte, error) { type MachineConfig struct { // CpuCount: The number of CPU's in the VM instance. CpuCount int64 `json:"cpuCount,omitempty"` + // MachineType: Machine type of the VM instance. E.g. "n2-highmem-4", + // "n2-highmem-8", "c4a-highmem-4-lssd". cpu_count must match the number of + // vCPUs in the machine type. + MachineType string `json:"machineType,omitempty"` // ForceSendFields is a list of field names (e.g. "CpuCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1880,18 +1961,20 @@ func (s MaintenanceSchedule) MarshalJSON() ([]byte, error) { // MaintenanceUpdatePolicy: MaintenanceUpdatePolicy defines the policy for // system updates. type MaintenanceUpdatePolicy struct { + // DenyMaintenancePeriods: Periods to deny maintenance. Currently limited to 1. + DenyMaintenancePeriods []*DenyMaintenancePeriod `json:"denyMaintenancePeriods,omitempty"` // MaintenanceWindows: Preferred windows to perform maintenance. Currently // limited to 1. MaintenanceWindows []*MaintenanceWindow `json:"maintenanceWindows,omitempty"` - // ForceSendFields is a list of field names (e.g. "MaintenanceWindows") to + // ForceSendFields is a list of field names (e.g. "DenyMaintenancePeriods") 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. "MaintenanceWindows") 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. "DenyMaintenancePeriods") 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:"-"` } @@ -3364,6 +3447,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -3827,6 +3914,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalDa // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalMetadata") to // unconditionally include in API requests. By default, fields with empty or diff --git a/alloydb/v1alpha/alloydb-api.json b/alloydb/v1alpha/alloydb-api.json index e2f112a67d..7d21bf6c21 100644 --- a/alloydb/v1alpha/alloydb-api.json +++ b/alloydb/v1alpha/alloydb-api.json @@ -1616,7 +1616,7 @@ } } }, - "revision": "20250227", + "revision": "20250308", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2456,6 +2456,25 @@ }, "type": "object" }, + "DenyMaintenancePeriod": { + "description": "DenyMaintenancePeriod definition. Excepting emergencies, maintenance will not be scheduled to start within this deny period. The start_date must be less than the end_date.", + "id": "DenyMaintenancePeriod", + "properties": { + "endDate": { + "$ref": "GoogleTypeDate", + "description": "Deny period end date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring" + }, + "startDate": { + "$ref": "GoogleTypeDate", + "description": "Deny period start date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring" + }, + "time": { + "$ref": "GoogleTypeTimeOfDay", + "description": "Time in UTC when the deny period starts on start_date and ends on end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -2648,6 +2667,28 @@ }, "type": "object" }, + "GoogleTypeDate": { + "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", + "id": "GoogleTypeDate", + "properties": { + "day": { + "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", + "format": "int32", + "type": "integer" + }, + "month": { + "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", + "format": "int32", + "type": "integer" + }, + "year": { + "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "GoogleTypeTimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "GoogleTypeTimeOfDay", @@ -2959,6 +3000,11 @@ "enablePublicIp": { "description": "Optional. Enabling public ip for the instance.", "type": "boolean" + }, + "network": { + "description": "Output only. The resource link for the VPC network in which instance resources are created and from which they are accessible via Private IP. This will be the same value as the parent cluster's network. It is specified in the form: // `projects/{project_number}/global/networks/{network_id}`.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -3175,6 +3221,10 @@ "description": "The number of CPU's in the VM instance.", "format": "int32", "type": "integer" + }, + "machineType": { + "description": "Machine type of the VM instance. E.g. \"n2-highmem-4\", \"n2-highmem-8\", \"c4a-highmem-4-lssd\". cpu_count must match the number of vCPUs in the machine type.", + "type": "string" } }, "type": "object" @@ -3196,6 +3246,13 @@ "description": "MaintenanceUpdatePolicy defines the policy for system updates.", "id": "MaintenanceUpdatePolicy", "properties": { + "denyMaintenancePeriods": { + "description": "Periods to deny maintenance. Currently limited to 1.", + "items": { + "$ref": "DenyMaintenancePeriod" + }, + "type": "array" + }, "maintenanceWindows": { "description": "Preferred windows to perform maintenance. Currently limited to 1.", "items": { @@ -3317,6 +3374,10 @@ "description": "Observability Instance specific configuration.", "id": "ObservabilityInstanceConfig", "properties": { + "assistiveExperiencesEnabled": { + "description": "Whether assistive experiences are enabled for this AlloyDB instance.", + "type": "boolean" + }, "enabled": { "description": "Observability feature status for an instance. This flag is turned \"off\" by default.", "type": "boolean" @@ -4348,7 +4409,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -4438,6 +4501,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -4528,7 +4593,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" }, @@ -4937,7 +5004,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -5027,6 +5096,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -5117,7 +5188,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" } diff --git a/alloydb/v1alpha/alloydb-gen.go b/alloydb/v1alpha/alloydb-gen.go index 226bbf7430..fc28d21c35 100644 --- a/alloydb/v1alpha/alloydb-gen.go +++ b/alloydb/v1alpha/alloydb-gen.go @@ -1016,6 +1016,39 @@ func (s CsvImportOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DenyMaintenancePeriod: DenyMaintenancePeriod definition. Excepting +// emergencies, maintenance will not be scheduled to start within this deny +// period. The start_date must be less than the end_date. +type DenyMaintenancePeriod struct { + // EndDate: Deny period end date. This can be: * A full date, with non-zero + // year, month and day values OR * A month and day value, with a zero year for + // recurring + EndDate *GoogleTypeDate `json:"endDate,omitempty"` + // StartDate: Deny period start date. This can be: * A full date, with non-zero + // year, month and day values OR * A month and day value, with a zero year for + // recurring + StartDate *GoogleTypeDate `json:"startDate,omitempty"` + // Time: Time in UTC when the deny period starts on start_date and ends on + // end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC + Time *GoogleTypeTimeOfDay `json:"time,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndDate") 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. "EndDate") 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 DenyMaintenancePeriod) MarshalJSON() ([]byte, error) { + type NoMethod DenyMaintenancePeriod + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -1326,6 +1359,44 @@ func (s GoogleCloudLocationLocation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleTypeDate: Represents a whole or partial calendar date, such as a +// birthday. The time of day and time zone are either specified elsewhere or +// are insignificant. The date is relative to the Gregorian Calendar. This can +// represent one of the following: * A full date, with non-zero year, month, +// and day values. * A month and day, with a zero year (for example, an +// anniversary). * A year on its own, with a zero month and a zero day. * A +// year and month, with a zero day (for example, a credit card expiration +// date). Related types: * google.type.TimeOfDay * google.type.DateTime * +// google.protobuf.Timestamp +type GoogleTypeDate struct { + // Day: Day of a month. Must be from 1 to 31 and valid for the year and month, + // or 0 to specify a year by itself or a year and month where the day isn't + // significant. + Day int64 `json:"day,omitempty"` + // Month: Month of a year. Must be from 1 to 12, or 0 to specify a year without + // a month and day. + Month int64 `json:"month,omitempty"` + // Year: Year of the date. Must be from 1 to 9999, or 0 to specify a date + // without a year. + Year int64 `json:"year,omitempty"` + // ForceSendFields is a list of field names (e.g. "Day") 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. "Day") 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 GoogleTypeDate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeDate + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleTypeTimeOfDay: Represents a time of day. The date and time zone are // either not significant or are specified elsewhere. An API may choose to // allow leap seconds. Related types are google.type.Date and @@ -1623,6 +1694,12 @@ type InstanceNetworkConfig struct { EnableOutboundPublicIp bool `json:"enableOutboundPublicIp,omitempty"` // EnablePublicIp: Optional. Enabling public ip for the instance. EnablePublicIp bool `json:"enablePublicIp,omitempty"` + // Network: Output only. The resource link for the VPC network in which + // instance resources are created and from which they are accessible via + // Private IP. This will be the same value as the parent cluster's network. It + // is specified in the form: // + // `projects/{project_number}/global/networks/{network_id}`. + Network string `json:"network,omitempty"` // ForceSendFields is a list of field names (e.g. "AuthorizedExternalNetworks") // to unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1894,6 +1971,10 @@ func (s ListUsersResponse) MarshalJSON() ([]byte, error) { type MachineConfig struct { // CpuCount: The number of CPU's in the VM instance. CpuCount int64 `json:"cpuCount,omitempty"` + // MachineType: Machine type of the VM instance. E.g. "n2-highmem-4", + // "n2-highmem-8", "c4a-highmem-4-lssd". cpu_count must match the number of + // vCPUs in the machine type. + MachineType string `json:"machineType,omitempty"` // ForceSendFields is a list of field names (e.g. "CpuCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1941,18 +2022,20 @@ func (s MaintenanceSchedule) MarshalJSON() ([]byte, error) { // MaintenanceUpdatePolicy: MaintenanceUpdatePolicy defines the policy for // system updates. type MaintenanceUpdatePolicy struct { + // DenyMaintenancePeriods: Periods to deny maintenance. Currently limited to 1. + DenyMaintenancePeriods []*DenyMaintenancePeriod `json:"denyMaintenancePeriods,omitempty"` // MaintenanceWindows: Preferred windows to perform maintenance. Currently // limited to 1. MaintenanceWindows []*MaintenanceWindow `json:"maintenanceWindows,omitempty"` - // ForceSendFields is a list of field names (e.g. "MaintenanceWindows") to + // ForceSendFields is a list of field names (e.g. "DenyMaintenancePeriods") 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. "MaintenanceWindows") 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. "DenyMaintenancePeriods") 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:"-"` } @@ -2101,6 +2184,9 @@ func (s Node) MarshalJSON() ([]byte, error) { // ObservabilityInstanceConfig: Observability Instance specific configuration. type ObservabilityInstanceConfig struct { + // AssistiveExperiencesEnabled: Whether assistive experiences are enabled for + // this AlloyDB instance. + AssistiveExperiencesEnabled bool `json:"assistiveExperiencesEnabled,omitempty"` // Enabled: Observability feature status for an instance. This flag is turned // "off" by default. Enabled bool `json:"enabled,omitempty"` @@ -2128,15 +2214,15 @@ type ObservabilityInstanceConfig struct { // This flag is turned "on" by default but tracking is enabled only after // observability enabled flag is also turned on. TrackWaitEvents bool `json:"trackWaitEvents,omitempty"` - // ForceSendFields is a list of field names (e.g. "Enabled") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. + // ForceSendFields is a list of field names (e.g. + // "AssistiveExperiencesEnabled") 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. "Enabled") 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. "AssistiveExperiencesEnabled") 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:"-"` } @@ -3425,6 +3511,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -3888,6 +3978,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalDa // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalMetadata") to // unconditionally include in API requests. By default, fields with empty or diff --git a/alloydb/v1beta/alloydb-api.json b/alloydb/v1beta/alloydb-api.json index 883c9b42d5..2e0ad6129c 100644 --- a/alloydb/v1beta/alloydb-api.json +++ b/alloydb/v1beta/alloydb-api.json @@ -1613,7 +1613,7 @@ } } }, - "revision": "20250227", + "revision": "20250308", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2437,6 +2437,25 @@ }, "type": "object" }, + "DenyMaintenancePeriod": { + "description": "DenyMaintenancePeriod definition. Excepting emergencies, maintenance will not be scheduled to start within this deny period. The start_date must be less than the end_date.", + "id": "DenyMaintenancePeriod", + "properties": { + "endDate": { + "$ref": "GoogleTypeDate", + "description": "Deny period end date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring" + }, + "startDate": { + "$ref": "GoogleTypeDate", + "description": "Deny period start date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring" + }, + "time": { + "$ref": "GoogleTypeTimeOfDay", + "description": "Time in UTC when the deny period starts on start_date and ends on end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -2629,6 +2648,28 @@ }, "type": "object" }, + "GoogleTypeDate": { + "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", + "id": "GoogleTypeDate", + "properties": { + "day": { + "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", + "format": "int32", + "type": "integer" + }, + "month": { + "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", + "format": "int32", + "type": "integer" + }, + "year": { + "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "GoogleTypeTimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "GoogleTypeTimeOfDay", @@ -2935,6 +2976,11 @@ "enablePublicIp": { "description": "Optional. Enabling public ip for the instance.", "type": "boolean" + }, + "network": { + "description": "Output only. The resource link for the VPC network in which instance resources are created and from which they are accessible via Private IP. This will be the same value as the parent cluster's network. It is specified in the form: // `projects/{project_number}/global/networks/{network_id}`.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -3151,6 +3197,10 @@ "description": "The number of CPU's in the VM instance.", "format": "int32", "type": "integer" + }, + "machineType": { + "description": "Machine type of the VM instance. E.g. \"n2-highmem-4\", \"n2-highmem-8\", \"c4a-highmem-4-lssd\". cpu_count must match the number of vCPUs in the machine type.", + "type": "string" } }, "type": "object" @@ -3172,6 +3222,13 @@ "description": "MaintenanceUpdatePolicy defines the policy for system updates.", "id": "MaintenanceUpdatePolicy", "properties": { + "denyMaintenancePeriods": { + "description": "Periods to deny maintenance. Currently limited to 1.", + "items": { + "$ref": "DenyMaintenancePeriod" + }, + "type": "array" + }, "maintenanceWindows": { "description": "Preferred windows to perform maintenance. Currently limited to 1.", "items": { @@ -3293,6 +3350,10 @@ "description": "Observability Instance specific configuration.", "id": "ObservabilityInstanceConfig", "properties": { + "assistiveExperiencesEnabled": { + "description": "Whether assistive experiences are enabled for this AlloyDB instance.", + "type": "boolean" + }, "enabled": { "description": "Observability feature status for an instance. This flag is turned \"off\" by default.", "type": "boolean" @@ -4324,7 +4385,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -4414,6 +4477,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -4504,7 +4569,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" }, @@ -4913,7 +4980,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -5003,6 +5072,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -5093,7 +5164,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" } diff --git a/alloydb/v1beta/alloydb-gen.go b/alloydb/v1beta/alloydb-gen.go index 011e45b1d7..c18a9d3d74 100644 --- a/alloydb/v1beta/alloydb-gen.go +++ b/alloydb/v1beta/alloydb-gen.go @@ -1008,6 +1008,39 @@ func (s CsvImportOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DenyMaintenancePeriod: DenyMaintenancePeriod definition. Excepting +// emergencies, maintenance will not be scheduled to start within this deny +// period. The start_date must be less than the end_date. +type DenyMaintenancePeriod struct { + // EndDate: Deny period end date. This can be: * A full date, with non-zero + // year, month and day values OR * A month and day value, with a zero year for + // recurring + EndDate *GoogleTypeDate `json:"endDate,omitempty"` + // StartDate: Deny period start date. This can be: * A full date, with non-zero + // year, month and day values OR * A month and day value, with a zero year for + // recurring + StartDate *GoogleTypeDate `json:"startDate,omitempty"` + // Time: Time in UTC when the deny period starts on start_date and ends on + // end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC + Time *GoogleTypeTimeOfDay `json:"time,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndDate") 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. "EndDate") 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 DenyMaintenancePeriod) MarshalJSON() ([]byte, error) { + type NoMethod DenyMaintenancePeriod + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -1318,6 +1351,44 @@ func (s GoogleCloudLocationLocation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleTypeDate: Represents a whole or partial calendar date, such as a +// birthday. The time of day and time zone are either specified elsewhere or +// are insignificant. The date is relative to the Gregorian Calendar. This can +// represent one of the following: * A full date, with non-zero year, month, +// and day values. * A month and day, with a zero year (for example, an +// anniversary). * A year on its own, with a zero month and a zero day. * A +// year and month, with a zero day (for example, a credit card expiration +// date). Related types: * google.type.TimeOfDay * google.type.DateTime * +// google.protobuf.Timestamp +type GoogleTypeDate struct { + // Day: Day of a month. Must be from 1 to 31 and valid for the year and month, + // or 0 to specify a year by itself or a year and month where the day isn't + // significant. + Day int64 `json:"day,omitempty"` + // Month: Month of a year. Must be from 1 to 12, or 0 to specify a year without + // a month and day. + Month int64 `json:"month,omitempty"` + // Year: Year of the date. Must be from 1 to 9999, or 0 to specify a date + // without a year. + Year int64 `json:"year,omitempty"` + // ForceSendFields is a list of field names (e.g. "Day") 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. "Day") 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 GoogleTypeDate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeDate + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleTypeTimeOfDay: Represents a time of day. The date and time zone are // either not significant or are specified elsewhere. An API may choose to // allow leap seconds. Related types are google.type.Date and @@ -1613,6 +1684,12 @@ type InstanceNetworkConfig struct { EnableOutboundPublicIp bool `json:"enableOutboundPublicIp,omitempty"` // EnablePublicIp: Optional. Enabling public ip for the instance. EnablePublicIp bool `json:"enablePublicIp,omitempty"` + // Network: Output only. The resource link for the VPC network in which + // instance resources are created and from which they are accessible via + // Private IP. This will be the same value as the parent cluster's network. It + // is specified in the form: // + // `projects/{project_number}/global/networks/{network_id}`. + Network string `json:"network,omitempty"` // ForceSendFields is a list of field names (e.g. "AuthorizedExternalNetworks") // to unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1884,6 +1961,10 @@ func (s ListUsersResponse) MarshalJSON() ([]byte, error) { type MachineConfig struct { // CpuCount: The number of CPU's in the VM instance. CpuCount int64 `json:"cpuCount,omitempty"` + // MachineType: Machine type of the VM instance. E.g. "n2-highmem-4", + // "n2-highmem-8", "c4a-highmem-4-lssd". cpu_count must match the number of + // vCPUs in the machine type. + MachineType string `json:"machineType,omitempty"` // ForceSendFields is a list of field names (e.g. "CpuCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1931,18 +2012,20 @@ func (s MaintenanceSchedule) MarshalJSON() ([]byte, error) { // MaintenanceUpdatePolicy: MaintenanceUpdatePolicy defines the policy for // system updates. type MaintenanceUpdatePolicy struct { + // DenyMaintenancePeriods: Periods to deny maintenance. Currently limited to 1. + DenyMaintenancePeriods []*DenyMaintenancePeriod `json:"denyMaintenancePeriods,omitempty"` // MaintenanceWindows: Preferred windows to perform maintenance. Currently // limited to 1. MaintenanceWindows []*MaintenanceWindow `json:"maintenanceWindows,omitempty"` - // ForceSendFields is a list of field names (e.g. "MaintenanceWindows") to + // ForceSendFields is a list of field names (e.g. "DenyMaintenancePeriods") 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. "MaintenanceWindows") 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. "DenyMaintenancePeriods") 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:"-"` } @@ -2091,6 +2174,9 @@ func (s Node) MarshalJSON() ([]byte, error) { // ObservabilityInstanceConfig: Observability Instance specific configuration. type ObservabilityInstanceConfig struct { + // AssistiveExperiencesEnabled: Whether assistive experiences are enabled for + // this AlloyDB instance. + AssistiveExperiencesEnabled bool `json:"assistiveExperiencesEnabled,omitempty"` // Enabled: Observability feature status for an instance. This flag is turned // "off" by default. Enabled bool `json:"enabled,omitempty"` @@ -2118,15 +2204,15 @@ type ObservabilityInstanceConfig struct { // This flag is turned "on" by default but tracking is enabled only after // observability enabled flag is also turned on. TrackWaitEvents bool `json:"trackWaitEvents,omitempty"` - // ForceSendFields is a list of field names (e.g. "Enabled") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. + // ForceSendFields is a list of field names (e.g. + // "AssistiveExperiencesEnabled") 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. "Enabled") 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. "AssistiveExperiencesEnabled") 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:"-"` } @@ -3415,6 +3501,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -3878,6 +3968,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalDa // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalMetadata") to // unconditionally include in API requests. By default, fields with empty or diff --git a/analyticshub/v1/analyticshub-api.json b/analyticshub/v1/analyticshub-api.json index b1b6d51073..2aeebd305f 100644 --- a/analyticshub/v1/analyticshub-api.json +++ b/analyticshub/v1/analyticshub-api.json @@ -1027,7 +1027,7 @@ } } }, - "revision": "20250303", + "revision": "20250310", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { "AnalyticsHubSubscriptionInfo": { @@ -1966,8 +1966,13 @@ "description": "All supported message transforms types.", "id": "MessageTransform", "properties": { + "disabled": { + "description": "Optional. If true, the transform is disabled and will not be applied to messages. Defaults to `false`.", + "type": "boolean" + }, "enabled": { - "description": "Optional. If set to true, the transform is enabled. If false, the transform is disabled and will not be applied to messages. Defaults to `true`.", + "deprecated": true, + "description": "Optional. This field is deprecated, use the `disabled` field to disable transforms.", "type": "boolean" }, "javascriptUdf": { diff --git a/analyticshub/v1/analyticshub-gen.go b/analyticshub/v1/analyticshub-gen.go index 537e32d1b3..9ceb034d9b 100644 --- a/analyticshub/v1/analyticshub-gen.go +++ b/analyticshub/v1/analyticshub-gen.go @@ -1658,21 +1658,23 @@ func (s Listing) MarshalJSON() ([]byte, error) { // MessageTransform: All supported message transforms types. type MessageTransform struct { - // Enabled: Optional. If set to true, the transform is enabled. If false, the - // transform is disabled and will not be applied to messages. Defaults to - // `true`. + // Disabled: Optional. If true, the transform is disabled and will not be + // applied to messages. Defaults to `false`. + Disabled bool `json:"disabled,omitempty"` + // Enabled: Optional. This field is deprecated, use the `disabled` field to + // disable transforms. Enabled bool `json:"enabled,omitempty"` // JavascriptUdf: Optional. JavaScript User Defined Function. If multiple // JavaScriptUDF's are specified on a resource, each must have a unique // `function_name`. JavascriptUdf *JavaScriptUDF `json:"javascriptUdf,omitempty"` - // ForceSendFields is a list of field names (e.g. "Enabled") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Disabled") 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. "Enabled") to include in API + // NullFields is a list of field names (e.g. "Disabled") 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. diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index b3625a9c45..f8de8b5534 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -419,7 +419,7 @@ ], "parameters": { "changesNotSentForReview": { - "description": "Indicates that the changes in this edit will not be reviewed until they are explicitly sent for review from the Google Play Console UI. These changes will be added to any other changes that are not yet sent for review.", + "description": "When a rejection happens, the parameter will make sure that the changes in this edit won't be reviewed until they are explicitly sent for review from within the Google Play Console UI. These changes will be added to any other changes that are not yet sent for review.", "location": "query", "type": "boolean" }, @@ -4732,7 +4732,7 @@ } } }, - "revision": "20250227", + "revision": "20250318", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 637791574e..6dca6c2954 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -8715,10 +8715,10 @@ func (r *EditsService) Commit(packageName string, editId string) *EditsCommitCal } // ChangesNotSentForReview sets the optional parameter -// "changesNotSentForReview": Indicates that the changes in this edit will not -// be reviewed until they are explicitly sent for review from the Google Play -// Console UI. These changes will be added to any other changes that are not -// yet sent for review. +// "changesNotSentForReview": When a rejection happens, the parameter will make +// sure that the changes in this edit won't be reviewed until they are +// explicitly sent for review from within the Google Play Console UI. These +// changes will be added to any other changes that are not yet sent for review. func (c *EditsCommitCall) ChangesNotSentForReview(changesNotSentForReview bool) *EditsCommitCall { c.urlParams_.Set("changesNotSentForReview", fmt.Sprint(changesNotSentForReview)) return c diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index 9b3e05270c..fa3260b9b2 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -3821,6 +3821,129 @@ } } }, + "dnsZones": { + "methods": { + "create": { + "description": "Creates a new DNS zone.", + "flatPath": "v1/organizations/{organizationsId}/dnsZones", + "httpMethod": "POST", + "id": "apigee.organizations.dnsZones.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "dnsZoneId": { + "description": "Required. User assigned ID for this resource. Must be unique within the organization. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Organization where the DNS zone will be created.", + "location": "path", + "pattern": "^organizations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/dnsZones", + "request": { + "$ref": "GoogleCloudApigeeV1DnsZone" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a previously created DNS zone.", + "flatPath": "v1/organizations/{organizationsId}/dnsZones/{dnsZonesId}", + "httpMethod": "DELETE", + "id": "apigee.organizations.dnsZones.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the DNS zone to delete. Use the following structure in your request: `organizations/{org}/dnsZones/{dns_zone}`.", + "location": "path", + "pattern": "^organizations/[^/]+/dnsZones/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Fetches the representation of an existing DNS zone.", + "flatPath": "v1/organizations/{organizationsId}/dnsZones/{dnsZonesId}", + "httpMethod": "GET", + "id": "apigee.organizations.dnsZones.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the DNS zone to fetch. Use the following structure in your request: `organizations/{org}/dnsZones/{dns_zone}`.", + "location": "path", + "pattern": "^organizations/[^/]+/dnsZones/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleCloudApigeeV1DnsZone" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Enumerates DNS zones that have been created but not yet deleted.", + "flatPath": "v1/organizations/{organizationsId}/dnsZones", + "httpMethod": "GET", + "id": "apigee.organizations.dnsZones.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Maximum number of DNS zones to return. If unspecified, at most 25 DNS zones will be returned.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token, returned from a previous `ListDnsZones` call, that you can use to retrieve the next page.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Name of the organization for which to list the DNS zones. Use the following structure in your request: `organizations/{org}`", + "location": "path", + "pattern": "^organizations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/dnsZones", + "response": { + "$ref": "GoogleCloudApigeeV1ListDnsZonesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "endpointAttachments": { "methods": { "create": { @@ -9405,6 +9528,168 @@ } } }, + "securityMonitoringConditions": { + "methods": { + "create": { + "description": "Create a security monitoring condition.", + "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions", + "httpMethod": "POST", + "id": "apigee.organizations.securityMonitoringConditions.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name. Format: `organizations/{org}`", + "location": "path", + "pattern": "^organizations/[^/]+$", + "required": true, + "type": "string" + }, + "securityMonitoringConditionId": { + "description": "Optional. Optional: The security monitoring condition id. If not specified, a monitoring condition uuid will be generated by the backend. This value should be 4-63 characters, and valid characters are /a-z-/.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/securityMonitoringConditions", + "request": { + "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" + }, + "response": { + "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete a security monitoring condition.", + "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions/{securityMonitoringConditionsId}", + "httpMethod": "DELETE", + "id": "apigee.organizations.securityMonitoringConditions.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the security monitoring condition to delete. Format: `organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}`", + "location": "path", + "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get a security monitoring condition.", + "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions/{securityMonitoringConditionsId}", + "httpMethod": "GET", + "id": "apigee.organizations.securityMonitoringConditions.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the security monitoring condition to get. Format: `organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}`", + "location": "path", + "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "List security monitoring conditions.", + "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions", + "httpMethod": "GET", + "id": "apigee.organizations.securityMonitoringConditions.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filter for the monitoring conditions. For example: `profile=profile1 AND scope=env1`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of monitoring conditions to return.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListSecurityMonitoringConditions` call. Provide this to retrieve the subsequent page.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. For a specific organization, list all the security monitoring conditions. Format: `organizations/{org}`", + "location": "path", + "pattern": "^organizations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/securityMonitoringConditions", + "response": { + "$ref": "GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a security monitoring condition.", + "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions/{securityMonitoringConditionsId}", + "httpMethod": "PATCH", + "id": "apigee.organizations.securityMonitoringConditions.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}", + "location": "path", + "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update. Valid fields to update are `profile`, `scope`, `include_all_resources`, `include`, and `exclude`.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" + }, + "response": { + "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "securityProfiles": { "methods": { "create": { @@ -10778,7 +11063,7 @@ } } }, - "revision": "20250306", + "revision": "20250312", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -13670,6 +13955,75 @@ "properties": {}, "type": "object" }, + "GoogleCloudApigeeV1DnsZone": { + "description": "A DNS zone is a resource under an Apigee organization that is used to create a DNS peering with Apigee's network. DNS peering will let Apigee instances resolve the hostnames created in a peered network.", + "id": "GoogleCloudApigeeV1DnsZone", + "properties": { + "createTime": { + "description": "Output only. The time that this resource was created on the server.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Required. Description of the resource. String of at most 1024 characters associated with this resource for the user's convenience.", + "type": "string" + }, + "domain": { + "description": "Required. The domain name for hosts in this private zone, for instance \"example.com.\".", + "type": "string" + }, + "name": { + "description": "Identifier. Unique name for the resource. Defined by the server Format: \"organizations/{organization}/dnsZones/{dns_zone}\".", + "type": "string" + }, + "peeringConfig": { + "$ref": "GoogleCloudApigeeV1DnsZonePeeringConfig", + "description": "DNS PEERING zone configuration." + }, + "state": { + "description": "Output only. State of the DNS Peering. Values other than `ACTIVE` mean the resource is not ready to use.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "DELETING", + "UPDATING" + ], + "enumDescriptions": [ + "Resource is in an unspecified state.", + "Resource is being created.", + "Resource is provisioned and ready to use.", + "The resource is being deleted.", + "The resource is being updated." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time that this resource was updated on the server.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudApigeeV1DnsZonePeeringConfig": { + "description": "Fields for DNS PEERING zone.", + "id": "GoogleCloudApigeeV1DnsZonePeeringConfig", + "properties": { + "targetNetworkId": { + "description": "Required. The VPC network where the records for that private DNS zone's namespace are available. Apigee will be performing DNS peering with this VPC network.", + "type": "string" + }, + "targetProjectId": { + "description": "Required. The ID of the project containing the private DNS zone.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudApigeeV1DocumentationFile": { "description": "Documentation file contents for a catalog item.", "id": "GoogleCloudApigeeV1DocumentationFile", @@ -15179,6 +15533,24 @@ }, "type": "object" }, + "GoogleCloudApigeeV1ListDnsZonesResponse": { + "description": "Response for list DNS zones.", + "id": "GoogleCloudApigeeV1ListDnsZonesResponse", + "properties": { + "dnsZones": { + "description": "DNS zones in a given organization.", + "items": { + "$ref": "GoogleCloudApigeeV1DnsZone" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Page token that you can include in an `ListDnsZones` request to retrieve the next page. If omitted, no subsequent pages exist.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudApigeeV1ListEndpointAttachmentsResponse": { "description": "Response for ListEndpointAttachments method.", "id": "GoogleCloudApigeeV1ListEndpointAttachmentsResponse", @@ -15426,6 +15798,24 @@ }, "type": "object" }, + "GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse": { + "description": "Response for ListSecurityMonitoringConditions.", + "id": "GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse", + "properties": { + "nextPageToken": { + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "securityMonitoringConditions": { + "description": "List of security monitoring conditions in the organization.", + "items": { + "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse": { "description": "Response for ListSecurityProfileRevisions.", "id": "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse", @@ -18036,6 +18426,57 @@ }, "type": "object" }, + "GoogleCloudApigeeV1SecurityMonitoringCondition": { + "description": "Security monitoring condition for risk assessment version 2.", + "id": "GoogleCloudApigeeV1SecurityMonitoringCondition", + "properties": { + "createTime": { + "description": "Output only. The time of the security monitoring condition creation.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "include": { + "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray", + "description": "Include only these resources." + }, + "includeAllResources": { + "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll", + "description": "Include all resources under the scope." + }, + "name": { + "description": "Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}", + "type": "string" + }, + "profile": { + "description": "Required. ID of security profile of the security monitoring condition.", + "type": "string" + }, + "scope": { + "description": "Required. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources.", + "type": "string" + }, + "totalDeployedResources": { + "description": "Output only. Total number of deployed resources within scope.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "totalMonitoredResources": { + "description": "Output only. Total number of monitored resources within this condition.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "updateTime": { + "description": "Output only. The time of the security monitoring condition update.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudApigeeV1SecurityProfile": { "description": "Represents a SecurityProfile resource.", "id": "GoogleCloudApigeeV1SecurityProfile", diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 697b3c2198..ed3d8e623b 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -194,6 +194,7 @@ func NewOrganizationsService(s *Service) *OrganizationsService { rs.Datacollectors = NewOrganizationsDatacollectorsService(s) rs.Deployments = NewOrganizationsDeploymentsService(s) rs.Developers = NewOrganizationsDevelopersService(s) + rs.DnsZones = NewOrganizationsDnsZonesService(s) rs.EndpointAttachments = NewOrganizationsEndpointAttachmentsService(s) rs.Envgroups = NewOrganizationsEnvgroupsService(s) rs.Environments = NewOrganizationsEnvironmentsService(s) @@ -206,6 +207,7 @@ func NewOrganizationsService(s *Service) *OrganizationsService { rs.OptimizedHostStats = NewOrganizationsOptimizedHostStatsService(s) rs.Reports = NewOrganizationsReportsService(s) rs.SecurityAssessmentResults = NewOrganizationsSecurityAssessmentResultsService(s) + rs.SecurityMonitoringConditions = NewOrganizationsSecurityMonitoringConditionsService(s) rs.SecurityProfiles = NewOrganizationsSecurityProfilesService(s) rs.SecurityProfilesV2 = NewOrganizationsSecurityProfilesV2Service(s) rs.Sharedflows = NewOrganizationsSharedflowsService(s) @@ -233,6 +235,8 @@ type OrganizationsService struct { Developers *OrganizationsDevelopersService + DnsZones *OrganizationsDnsZonesService + EndpointAttachments *OrganizationsEndpointAttachmentsService Envgroups *OrganizationsEnvgroupsService @@ -257,6 +261,8 @@ type OrganizationsService struct { SecurityAssessmentResults *OrganizationsSecurityAssessmentResultsService + SecurityMonitoringConditions *OrganizationsSecurityMonitoringConditionsService + SecurityProfiles *OrganizationsSecurityProfilesService SecurityProfilesV2 *OrganizationsSecurityProfilesV2Service @@ -580,6 +586,15 @@ type OrganizationsDevelopersSubscriptionsService struct { s *Service } +func NewOrganizationsDnsZonesService(s *Service) *OrganizationsDnsZonesService { + rs := &OrganizationsDnsZonesService{s: s} + return rs +} + +type OrganizationsDnsZonesService struct { + s *Service +} + func NewOrganizationsEndpointAttachmentsService(s *Service) *OrganizationsEndpointAttachmentsService { rs := &OrganizationsEndpointAttachmentsService{s: s} return rs @@ -1144,6 +1159,15 @@ type OrganizationsSecurityAssessmentResultsService struct { s *Service } +func NewOrganizationsSecurityMonitoringConditionsService(s *Service) *OrganizationsSecurityMonitoringConditionsService { + rs := &OrganizationsSecurityMonitoringConditionsService{s: s} + return rs +} + +type OrganizationsSecurityMonitoringConditionsService struct { + s *Service +} + func NewOrganizationsSecurityProfilesService(s *Service) *OrganizationsSecurityProfilesService { rs := &OrganizationsSecurityProfilesService{s: s} rs.Environments = NewOrganizationsSecurityProfilesEnvironmentsService(s) @@ -4518,6 +4542,86 @@ func (s GoogleCloudApigeeV1DimensionMetric) MarshalJSON() ([]byte, error) { type GoogleCloudApigeeV1DisableSecurityActionRequest struct { } +// GoogleCloudApigeeV1DnsZone: A DNS zone is a resource under an Apigee +// organization that is used to create a DNS peering with Apigee's network. DNS +// peering will let Apigee instances resolve the hostnames created in a peered +// network. +type GoogleCloudApigeeV1DnsZone struct { + // CreateTime: Output only. The time that this resource was created on the + // server. + CreateTime string `json:"createTime,omitempty"` + // Description: Required. Description of the resource. String of at most 1024 + // characters associated with this resource for the user's convenience. + Description string `json:"description,omitempty"` + // Domain: Required. The domain name for hosts in this private zone, for + // instance "example.com.". + Domain string `json:"domain,omitempty"` + // Name: Identifier. Unique name for the resource. Defined by the server + // Format: "organizations/{organization}/dnsZones/{dns_zone}". + Name string `json:"name,omitempty"` + // PeeringConfig: DNS PEERING zone configuration. + PeeringConfig *GoogleCloudApigeeV1DnsZonePeeringConfig `json:"peeringConfig,omitempty"` + // State: Output only. State of the DNS Peering. Values other than `ACTIVE` + // mean the resource is not ready to use. + // + // Possible values: + // "STATE_UNSPECIFIED" - Resource is in an unspecified state. + // "CREATING" - Resource is being created. + // "ACTIVE" - Resource is provisioned and ready to use. + // "DELETING" - The resource is being deleted. + // "UPDATING" - The resource is being updated. + State string `json:"state,omitempty"` + // UpdateTime: Output only. The time that this resource was updated on the + // server. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudApigeeV1DnsZone) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1DnsZone + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudApigeeV1DnsZonePeeringConfig: Fields for DNS PEERING zone. +type GoogleCloudApigeeV1DnsZonePeeringConfig struct { + // TargetNetworkId: Required. The VPC network where the records for that + // private DNS zone's namespace are available. Apigee will be performing DNS + // peering with this VPC network. + TargetNetworkId string `json:"targetNetworkId,omitempty"` + // TargetProjectId: Required. The ID of the project containing the private DNS + // zone. + TargetProjectId string `json:"targetProjectId,omitempty"` + // ForceSendFields is a list of field names (e.g. "TargetNetworkId") 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. "TargetNetworkId") 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 GoogleCloudApigeeV1DnsZonePeeringConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1DnsZonePeeringConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudApigeeV1DocumentationFile: Documentation file contents for a // catalog item. type GoogleCloudApigeeV1DocumentationFile struct { @@ -6464,6 +6568,34 @@ func (s GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1ListDnsZonesResponse: Response for list DNS zones. +type GoogleCloudApigeeV1ListDnsZonesResponse struct { + // DnsZones: DNS zones in a given organization. + DnsZones []*GoogleCloudApigeeV1DnsZone `json:"dnsZones,omitempty"` + // NextPageToken: Page token that you can include in an `ListDnsZones` request + // to retrieve the next page. If omitted, no subsequent pages exist. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "DnsZones") 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. "DnsZones") 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 GoogleCloudApigeeV1ListDnsZonesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1ListDnsZonesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudApigeeV1ListEndpointAttachmentsResponse: Response for // ListEndpointAttachments method. type GoogleCloudApigeeV1ListEndpointAttachmentsResponse struct { @@ -6879,6 +7011,36 @@ func (s GoogleCloudApigeeV1ListSecurityIncidentsResponse) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse: Response for +// ListSecurityMonitoringConditions. +type GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse struct { + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // SecurityMonitoringConditions: List of security monitoring conditions in the + // organization. + SecurityMonitoringConditions []*GoogleCloudApigeeV1SecurityMonitoringCondition `json:"securityMonitoringConditions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse: Response for // ListSecurityProfileRevisions. type GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse struct { @@ -10029,6 +10191,57 @@ func (s GoogleCloudApigeeV1SecurityIncident) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1SecurityMonitoringCondition: Security monitoring +// condition for risk assessment version 2. +type GoogleCloudApigeeV1SecurityMonitoringCondition struct { + // CreateTime: Output only. The time of the security monitoring condition + // creation. + CreateTime string `json:"createTime,omitempty"` + // Include: Include only these resources. + Include *GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray `json:"include,omitempty"` + // IncludeAllResources: Include all resources under the scope. + IncludeAllResources *GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll `json:"includeAllResources,omitempty"` + // Name: Identifier. Name of the security monitoring condition resource. + // Format: + // organizations/{org}/securityMonitoringConditions/{security_monitoring_conditi + // on} + Name string `json:"name,omitempty"` + // Profile: Required. ID of security profile of the security monitoring + // condition. + Profile string `json:"profile,omitempty"` + // Scope: Required. Scope of the security monitoring condition. For Apigee, the + // environment is the scope of the resources. + Scope string `json:"scope,omitempty"` + // TotalDeployedResources: Output only. Total number of deployed resources + // within scope. + TotalDeployedResources int64 `json:"totalDeployedResources,omitempty"` + // TotalMonitoredResources: Output only. Total number of monitored resources + // within this condition. + TotalMonitoredResources int64 `json:"totalMonitoredResources,omitempty"` + // UpdateTime: Output only. The time of the security monitoring condition + // update. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudApigeeV1SecurityMonitoringCondition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1SecurityMonitoringCondition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudApigeeV1SecurityProfile: Represents a SecurityProfile resource. type GoogleCloudApigeeV1SecurityProfile struct { // Description: Description of the security profile. @@ -26147,67 +26360,66 @@ func (c *OrganizationsDevelopersSubscriptionsListCall) Do(opts ...googleapi.Call return ret, nil } -type OrganizationsEndpointAttachmentsCreateCall struct { - s *Service - parent string - googlecloudapigeev1endpointattachment *GoogleCloudApigeeV1EndpointAttachment - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type OrganizationsDnsZonesCreateCall struct { + s *Service + parent string + googlecloudapigeev1dnszone *GoogleCloudApigeeV1DnsZone + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates an endpoint attachment. **Note:** Not supported for Apigee -// hybrid. +// Create: Creates a new DNS zone. // -// - parent: Organization the endpoint attachment will be created in. -func (r *OrganizationsEndpointAttachmentsService) Create(parent string, googlecloudapigeev1endpointattachment *GoogleCloudApigeeV1EndpointAttachment) *OrganizationsEndpointAttachmentsCreateCall { - c := &OrganizationsEndpointAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: Organization where the DNS zone will be created. +func (r *OrganizationsDnsZonesService) Create(parent string, googlecloudapigeev1dnszone *GoogleCloudApigeeV1DnsZone) *OrganizationsDnsZonesCreateCall { + c := &OrganizationsDnsZonesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googlecloudapigeev1endpointattachment = googlecloudapigeev1endpointattachment + c.googlecloudapigeev1dnszone = googlecloudapigeev1dnszone return c } -// EndpointAttachmentId sets the optional parameter "endpointAttachmentId": ID -// to use for the endpoint attachment. ID must start with a lowercase letter -// followed by up to 31 lowercase letters, numbers, or hyphens, and cannot end -// with a hyphen. The minimum length is 2. -func (c *OrganizationsEndpointAttachmentsCreateCall) EndpointAttachmentId(endpointAttachmentId string) *OrganizationsEndpointAttachmentsCreateCall { - c.urlParams_.Set("endpointAttachmentId", endpointAttachmentId) +// DnsZoneId sets the optional parameter "dnsZoneId": Required. User assigned +// ID for this resource. Must be unique within the organization. The name must +// be 1-63 characters long, must begin with a letter, end with a letter or +// digit, and only contain lowercase letters, digits or dashes. +func (c *OrganizationsDnsZonesCreateCall) DnsZoneId(dnsZoneId string) *OrganizationsDnsZonesCreateCall { + c.urlParams_.Set("dnsZoneId", dnsZoneId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsEndpointAttachmentsCreateCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsCreateCall { +func (c *OrganizationsDnsZonesCreateCall) Fields(s ...googleapi.Field) *OrganizationsDnsZonesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsEndpointAttachmentsCreateCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsCreateCall { +func (c *OrganizationsDnsZonesCreateCall) Context(ctx context.Context) *OrganizationsDnsZonesCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsEndpointAttachmentsCreateCall) Header() http.Header { +func (c *OrganizationsDnsZonesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsEndpointAttachmentsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsDnsZonesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1endpointattachment) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1dnszone) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/endpointAttachments") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dnsZones") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -26217,17 +26429,17 @@ func (c *OrganizationsEndpointAttachmentsCreateCall) doRequest(alt string) (*htt googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "apigee.organizations.endpointAttachments.create" call. +// Do executes the "apigee.organizations.dnsZones.create" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *OrganizationsEndpointAttachmentsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *OrganizationsDnsZonesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26257,11 +26469,11 @@ func (c *OrganizationsEndpointAttachmentsCreateCall) Do(opts ...googleapi.CallOp if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OrganizationsEndpointAttachmentsDeleteCall struct { +type OrganizationsDnsZonesDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -26269,12 +26481,12 @@ type OrganizationsEndpointAttachmentsDeleteCall struct { header_ http.Header } -// Delete: Deletes an endpoint attachment. +// Delete: Deletes a previously created DNS zone. // -// - name: Name of the endpoint attachment. Use the following structure in your -// request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`. -func (r *OrganizationsEndpointAttachmentsService) Delete(name string) *OrganizationsEndpointAttachmentsDeleteCall { - c := &OrganizationsEndpointAttachmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Name of the DNS zone to delete. Use the following structure in your +// request: `organizations/{org}/dnsZones/{dns_zone}`. +func (r *OrganizationsDnsZonesService) Delete(name string) *OrganizationsDnsZonesDeleteCall { + c := &OrganizationsDnsZonesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -26282,27 +26494,27 @@ func (r *OrganizationsEndpointAttachmentsService) Delete(name string) *Organizat // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsEndpointAttachmentsDeleteCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsDeleteCall { +func (c *OrganizationsDnsZonesDeleteCall) Fields(s ...googleapi.Field) *OrganizationsDnsZonesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsEndpointAttachmentsDeleteCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsDeleteCall { +func (c *OrganizationsDnsZonesDeleteCall) Context(ctx context.Context) *OrganizationsDnsZonesDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsEndpointAttachmentsDeleteCall) Header() http.Header { +func (c *OrganizationsDnsZonesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsEndpointAttachmentsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsDnsZonesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") @@ -26316,17 +26528,17 @@ func (c *OrganizationsEndpointAttachmentsDeleteCall) doRequest(alt string) (*htt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "apigee.organizations.endpointAttachments.delete" call. +// Do executes the "apigee.organizations.dnsZones.delete" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *OrganizationsEndpointAttachmentsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *OrganizationsDnsZonesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26356,11 +26568,11 @@ func (c *OrganizationsEndpointAttachmentsDeleteCall) Do(opts ...googleapi.CallOp if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OrganizationsEndpointAttachmentsGetCall struct { +type OrganizationsDnsZonesGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -26369,12 +26581,12 @@ type OrganizationsEndpointAttachmentsGetCall struct { header_ http.Header } -// Get: Gets the endpoint attachment. +// Get: Fetches the representation of an existing DNS zone. // -// - name: Name of the endpoint attachment. Use the following structure in your -// request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`. -func (r *OrganizationsEndpointAttachmentsService) Get(name string) *OrganizationsEndpointAttachmentsGetCall { - c := &OrganizationsEndpointAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Name of the DNS zone to fetch. Use the following structure in your +// request: `organizations/{org}/dnsZones/{dns_zone}`. +func (r *OrganizationsDnsZonesService) Get(name string) *OrganizationsDnsZonesGetCall { + c := &OrganizationsDnsZonesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -26382,7 +26594,7 @@ func (r *OrganizationsEndpointAttachmentsService) Get(name string) *Organization // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsEndpointAttachmentsGetCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsGetCall { +func (c *OrganizationsDnsZonesGetCall) Fields(s ...googleapi.Field) *OrganizationsDnsZonesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -26390,27 +26602,27 @@ func (c *OrganizationsEndpointAttachmentsGetCall) Fields(s ...googleapi.Field) * // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *OrganizationsEndpointAttachmentsGetCall) IfNoneMatch(entityTag string) *OrganizationsEndpointAttachmentsGetCall { +func (c *OrganizationsDnsZonesGetCall) IfNoneMatch(entityTag string) *OrganizationsDnsZonesGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsEndpointAttachmentsGetCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsGetCall { +func (c *OrganizationsDnsZonesGetCall) Context(ctx context.Context) *OrganizationsDnsZonesGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsEndpointAttachmentsGetCall) Header() http.Header { +func (c *OrganizationsDnsZonesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsEndpointAttachmentsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsDnsZonesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -26427,17 +26639,17 @@ func (c *OrganizationsEndpointAttachmentsGetCall) doRequest(alt string) (*http.R googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "apigee.organizations.endpointAttachments.get" call. +// Do executes the "apigee.organizations.dnsZones.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudApigeeV1EndpointAttachment.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudApigeeV1DnsZone.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *OrganizationsEndpointAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1EndpointAttachment, error) { +func (c *OrganizationsDnsZonesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1DnsZone, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26456,7 +26668,7 @@ func (c *OrganizationsEndpointAttachmentsGetCall) Do(opts ...googleapi.CallOptio if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudApigeeV1EndpointAttachment{ + ret := &GoogleCloudApigeeV1DnsZone{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26467,11 +26679,11 @@ func (c *OrganizationsEndpointAttachmentsGetCall) Do(opts ...googleapi.CallOptio if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OrganizationsEndpointAttachmentsListCall struct { +type OrganizationsDnsZonesListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -26480,28 +26692,26 @@ type OrganizationsEndpointAttachmentsListCall struct { header_ http.Header } -// List: Lists the endpoint attachments in an organization. +// List: Enumerates DNS zones that have been created but not yet deleted. // -// - parent: Name of the organization for which to list endpoint attachments. -// Use the following structure in your request: `organizations/{org}`. -func (r *OrganizationsEndpointAttachmentsService) List(parent string) *OrganizationsEndpointAttachmentsListCall { - c := &OrganizationsEndpointAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: Name of the organization for which to list the DNS zones. Use the +// following structure in your request: `organizations/{org}`. +func (r *OrganizationsDnsZonesService) List(parent string) *OrganizationsDnsZonesListCall { + c := &OrganizationsDnsZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// PageSize sets the optional parameter "pageSize": Maximum number of endpoint -// attachments to return. If unspecified, at most 25 attachments will be -// returned. -func (c *OrganizationsEndpointAttachmentsListCall) PageSize(pageSize int64) *OrganizationsEndpointAttachmentsListCall { +// PageSize sets the optional parameter "pageSize": Maximum number of DNS zones +// to return. If unspecified, at most 25 DNS zones will be returned. +func (c *OrganizationsDnsZonesListCall) PageSize(pageSize int64) *OrganizationsDnsZonesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": Page token, returned from -// a previous `ListEndpointAttachments` call, that you can use to retrieve the -// next page. -func (c *OrganizationsEndpointAttachmentsListCall) PageToken(pageToken string) *OrganizationsEndpointAttachmentsListCall { +// a previous `ListDnsZones` call, that you can use to retrieve the next page. +func (c *OrganizationsDnsZonesListCall) PageToken(pageToken string) *OrganizationsDnsZonesListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -26509,7 +26719,7 @@ func (c *OrganizationsEndpointAttachmentsListCall) PageToken(pageToken string) * // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsEndpointAttachmentsListCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsListCall { +func (c *OrganizationsDnsZonesListCall) Fields(s ...googleapi.Field) *OrganizationsDnsZonesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -26517,34 +26727,34 @@ func (c *OrganizationsEndpointAttachmentsListCall) Fields(s ...googleapi.Field) // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *OrganizationsEndpointAttachmentsListCall) IfNoneMatch(entityTag string) *OrganizationsEndpointAttachmentsListCall { +func (c *OrganizationsDnsZonesListCall) IfNoneMatch(entityTag string) *OrganizationsDnsZonesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsEndpointAttachmentsListCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsListCall { +func (c *OrganizationsDnsZonesListCall) Context(ctx context.Context) *OrganizationsDnsZonesListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsEndpointAttachmentsListCall) Header() http.Header { +func (c *OrganizationsDnsZonesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsEndpointAttachmentsListCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsDnsZonesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/endpointAttachments") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dnsZones") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -26554,17 +26764,17 @@ func (c *OrganizationsEndpointAttachmentsListCall) doRequest(alt string) (*http. googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "apigee.organizations.endpointAttachments.list" call. +// Do executes the "apigee.organizations.dnsZones.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudApigeeV1ListEndpointAttachmentsResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudApigeeV1ListDnsZonesResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *OrganizationsEndpointAttachmentsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1ListEndpointAttachmentsResponse, error) { +func (c *OrganizationsDnsZonesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1ListDnsZonesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26583,7 +26793,7 @@ func (c *OrganizationsEndpointAttachmentsListCall) Do(opts ...googleapi.CallOpti if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudApigeeV1ListEndpointAttachmentsResponse{ + ret := &GoogleCloudApigeeV1ListDnsZonesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26594,14 +26804,14 @@ func (c *OrganizationsEndpointAttachmentsListCall) Do(opts ...googleapi.CallOpti if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.dnsZones.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *OrganizationsEndpointAttachmentsListCall) Pages(ctx context.Context, f func(*GoogleCloudApigeeV1ListEndpointAttachmentsResponse) error) error { +func (c *OrganizationsDnsZonesListCall) Pages(ctx context.Context, f func(*GoogleCloudApigeeV1ListDnsZonesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -26619,65 +26829,67 @@ func (c *OrganizationsEndpointAttachmentsListCall) Pages(ctx context.Context, f } } -type OrganizationsEnvgroupsCreateCall struct { - s *Service - parent string - googlecloudapigeev1environmentgroup *GoogleCloudApigeeV1EnvironmentGroup - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type OrganizationsEndpointAttachmentsCreateCall struct { + s *Service + parent string + googlecloudapigeev1endpointattachment *GoogleCloudApigeeV1EndpointAttachment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a new environment group. +// Create: Creates an endpoint attachment. **Note:** Not supported for Apigee +// hybrid. // -// - parent: Name of the organization in which to create the environment group -// in the following format: `organizations/{org}`. -func (r *OrganizationsEnvgroupsService) Create(parent string, googlecloudapigeev1environmentgroup *GoogleCloudApigeeV1EnvironmentGroup) *OrganizationsEnvgroupsCreateCall { - c := &OrganizationsEnvgroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: Organization the endpoint attachment will be created in. +func (r *OrganizationsEndpointAttachmentsService) Create(parent string, googlecloudapigeev1endpointattachment *GoogleCloudApigeeV1EndpointAttachment) *OrganizationsEndpointAttachmentsCreateCall { + c := &OrganizationsEndpointAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googlecloudapigeev1environmentgroup = googlecloudapigeev1environmentgroup + c.googlecloudapigeev1endpointattachment = googlecloudapigeev1endpointattachment return c } -// Name sets the optional parameter "name": ID of the environment group. -// Overrides any ID in the environment_group resource. -func (c *OrganizationsEnvgroupsCreateCall) Name(name string) *OrganizationsEnvgroupsCreateCall { - c.urlParams_.Set("name", name) +// EndpointAttachmentId sets the optional parameter "endpointAttachmentId": ID +// to use for the endpoint attachment. ID must start with a lowercase letter +// followed by up to 31 lowercase letters, numbers, or hyphens, and cannot end +// with a hyphen. The minimum length is 2. +func (c *OrganizationsEndpointAttachmentsCreateCall) EndpointAttachmentId(endpointAttachmentId string) *OrganizationsEndpointAttachmentsCreateCall { + c.urlParams_.Set("endpointAttachmentId", endpointAttachmentId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsEnvgroupsCreateCall) Fields(s ...googleapi.Field) *OrganizationsEnvgroupsCreateCall { +func (c *OrganizationsEndpointAttachmentsCreateCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsEnvgroupsCreateCall) Context(ctx context.Context) *OrganizationsEnvgroupsCreateCall { +func (c *OrganizationsEndpointAttachmentsCreateCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsEnvgroupsCreateCall) Header() http.Header { +func (c *OrganizationsEndpointAttachmentsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsEnvgroupsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsEndpointAttachmentsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1environmentgroup) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1endpointattachment) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/envgroups") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/endpointAttachments") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -26687,17 +26899,487 @@ func (c *OrganizationsEnvgroupsCreateCall) doRequest(alt string) (*http.Response googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.envgroups.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "apigee.organizations.envgroups.create" call. +// Do executes the "apigee.organizations.endpointAttachments.create" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *OrganizationsEnvgroupsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *OrganizationsEndpointAttachmentsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type OrganizationsEndpointAttachmentsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an endpoint attachment. +// +// - name: Name of the endpoint attachment. Use the following structure in your +// request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`. +func (r *OrganizationsEndpointAttachmentsService) Delete(name string) *OrganizationsEndpointAttachmentsDeleteCall { + c := &OrganizationsEndpointAttachmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsEndpointAttachmentsDeleteCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsEndpointAttachmentsDeleteCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsEndpointAttachmentsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsEndpointAttachmentsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.endpointAttachments.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsEndpointAttachmentsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type OrganizationsEndpointAttachmentsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the endpoint attachment. +// +// - name: Name of the endpoint attachment. Use the following structure in your +// request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`. +func (r *OrganizationsEndpointAttachmentsService) Get(name string) *OrganizationsEndpointAttachmentsGetCall { + c := &OrganizationsEndpointAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsEndpointAttachmentsGetCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *OrganizationsEndpointAttachmentsGetCall) IfNoneMatch(entityTag string) *OrganizationsEndpointAttachmentsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsEndpointAttachmentsGetCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsEndpointAttachmentsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsEndpointAttachmentsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.endpointAttachments.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1EndpointAttachment.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsEndpointAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1EndpointAttachment, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1EndpointAttachment{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type OrganizationsEndpointAttachmentsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the endpoint attachments in an organization. +// +// - parent: Name of the organization for which to list endpoint attachments. +// Use the following structure in your request: `organizations/{org}`. +func (r *OrganizationsEndpointAttachmentsService) List(parent string) *OrganizationsEndpointAttachmentsListCall { + c := &OrganizationsEndpointAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of endpoint +// attachments to return. If unspecified, at most 25 attachments will be +// returned. +func (c *OrganizationsEndpointAttachmentsListCall) PageSize(pageSize int64) *OrganizationsEndpointAttachmentsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token, returned from +// a previous `ListEndpointAttachments` call, that you can use to retrieve the +// next page. +func (c *OrganizationsEndpointAttachmentsListCall) PageToken(pageToken string) *OrganizationsEndpointAttachmentsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsEndpointAttachmentsListCall) Fields(s ...googleapi.Field) *OrganizationsEndpointAttachmentsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *OrganizationsEndpointAttachmentsListCall) IfNoneMatch(entityTag string) *OrganizationsEndpointAttachmentsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsEndpointAttachmentsListCall) Context(ctx context.Context) *OrganizationsEndpointAttachmentsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsEndpointAttachmentsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsEndpointAttachmentsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/endpointAttachments") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.endpointAttachments.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1ListEndpointAttachmentsResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsEndpointAttachmentsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1ListEndpointAttachmentsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1ListEndpointAttachmentsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.endpointAttachments.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *OrganizationsEndpointAttachmentsListCall) Pages(ctx context.Context, f func(*GoogleCloudApigeeV1ListEndpointAttachmentsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type OrganizationsEnvgroupsCreateCall struct { + s *Service + parent string + googlecloudapigeev1environmentgroup *GoogleCloudApigeeV1EnvironmentGroup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new environment group. +// +// - parent: Name of the organization in which to create the environment group +// in the following format: `organizations/{org}`. +func (r *OrganizationsEnvgroupsService) Create(parent string, googlecloudapigeev1environmentgroup *GoogleCloudApigeeV1EnvironmentGroup) *OrganizationsEnvgroupsCreateCall { + c := &OrganizationsEnvgroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudapigeev1environmentgroup = googlecloudapigeev1environmentgroup + return c +} + +// Name sets the optional parameter "name": ID of the environment group. +// Overrides any ID in the environment_group resource. +func (c *OrganizationsEnvgroupsCreateCall) Name(name string) *OrganizationsEnvgroupsCreateCall { + c.urlParams_.Set("name", name) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsEnvgroupsCreateCall) Fields(s ...googleapi.Field) *OrganizationsEnvgroupsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsEnvgroupsCreateCall) Context(ctx context.Context) *OrganizationsEnvgroupsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsEnvgroupsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsEnvgroupsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1environmentgroup) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/envgroups") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.envgroups.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.envgroups.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsEnvgroupsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46692,6 +47374,601 @@ func (c *OrganizationsSecurityAssessmentResultsBatchComputeCall) Pages(ctx conte } } +type OrganizationsSecurityMonitoringConditionsCreateCall struct { + s *Service + parent string + googlecloudapigeev1securitymonitoringcondition *GoogleCloudApigeeV1SecurityMonitoringCondition + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Create a security monitoring condition. +// +// - parent: The parent resource name. Format: `organizations/{org}`. +func (r *OrganizationsSecurityMonitoringConditionsService) Create(parent string, googlecloudapigeev1securitymonitoringcondition *GoogleCloudApigeeV1SecurityMonitoringCondition) *OrganizationsSecurityMonitoringConditionsCreateCall { + c := &OrganizationsSecurityMonitoringConditionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudapigeev1securitymonitoringcondition = googlecloudapigeev1securitymonitoringcondition + return c +} + +// SecurityMonitoringConditionId sets the optional parameter +// "securityMonitoringConditionId": Optional: The security monitoring condition +// id. If not specified, a monitoring condition uuid will be generated by the +// backend. This value should be 4-63 characters, and valid characters are +// /a-z-/. +func (c *OrganizationsSecurityMonitoringConditionsCreateCall) SecurityMonitoringConditionId(securityMonitoringConditionId string) *OrganizationsSecurityMonitoringConditionsCreateCall { + c.urlParams_.Set("securityMonitoringConditionId", securityMonitoringConditionId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsSecurityMonitoringConditionsCreateCall) Fields(s ...googleapi.Field) *OrganizationsSecurityMonitoringConditionsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsSecurityMonitoringConditionsCreateCall) Context(ctx context.Context) *OrganizationsSecurityMonitoringConditionsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsSecurityMonitoringConditionsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsSecurityMonitoringConditionsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1securitymonitoringcondition) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/securityMonitoringConditions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.securityMonitoringConditions.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1SecurityMonitoringCondition.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsSecurityMonitoringConditionsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1SecurityMonitoringCondition, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1SecurityMonitoringCondition{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type OrganizationsSecurityMonitoringConditionsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Delete a security monitoring condition. +// +// - name: The name of the security monitoring condition to delete. Format: +// `organizations/{org}/securityMonitoringConditions/{security_monitoring_cond +// ition}`. +func (r *OrganizationsSecurityMonitoringConditionsService) Delete(name string) *OrganizationsSecurityMonitoringConditionsDeleteCall { + c := &OrganizationsSecurityMonitoringConditionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsSecurityMonitoringConditionsDeleteCall) Fields(s ...googleapi.Field) *OrganizationsSecurityMonitoringConditionsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsSecurityMonitoringConditionsDeleteCall) Context(ctx context.Context) *OrganizationsSecurityMonitoringConditionsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsSecurityMonitoringConditionsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsSecurityMonitoringConditionsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.securityMonitoringConditions.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *OrganizationsSecurityMonitoringConditionsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleProtobufEmpty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type OrganizationsSecurityMonitoringConditionsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Get a security monitoring condition. +// +// - name: The name of the security monitoring condition to get. Format: +// `organizations/{org}/securityMonitoringConditions/{security_monitoring_cond +// ition}`. +func (r *OrganizationsSecurityMonitoringConditionsService) Get(name string) *OrganizationsSecurityMonitoringConditionsGetCall { + c := &OrganizationsSecurityMonitoringConditionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsSecurityMonitoringConditionsGetCall) Fields(s ...googleapi.Field) *OrganizationsSecurityMonitoringConditionsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *OrganizationsSecurityMonitoringConditionsGetCall) IfNoneMatch(entityTag string) *OrganizationsSecurityMonitoringConditionsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsSecurityMonitoringConditionsGetCall) Context(ctx context.Context) *OrganizationsSecurityMonitoringConditionsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsSecurityMonitoringConditionsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsSecurityMonitoringConditionsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.securityMonitoringConditions.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1SecurityMonitoringCondition.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsSecurityMonitoringConditionsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1SecurityMonitoringCondition, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1SecurityMonitoringCondition{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type OrganizationsSecurityMonitoringConditionsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List security monitoring conditions. +// +// - parent: For a specific organization, list all the security monitoring +// conditions. Format: `organizations/{org}`. +func (r *OrganizationsSecurityMonitoringConditionsService) List(parent string) *OrganizationsSecurityMonitoringConditionsListCall { + c := &OrganizationsSecurityMonitoringConditionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter for the monitoring +// conditions. For example: `profile=profile1 AND scope=env1` +func (c *OrganizationsSecurityMonitoringConditionsListCall) Filter(filter string) *OrganizationsSecurityMonitoringConditionsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// monitoring conditions to return. +func (c *OrganizationsSecurityMonitoringConditionsListCall) PageSize(pageSize int64) *OrganizationsSecurityMonitoringConditionsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListSecurityMonitoringConditions` call. Provide this to +// retrieve the subsequent page. +func (c *OrganizationsSecurityMonitoringConditionsListCall) PageToken(pageToken string) *OrganizationsSecurityMonitoringConditionsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsSecurityMonitoringConditionsListCall) Fields(s ...googleapi.Field) *OrganizationsSecurityMonitoringConditionsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *OrganizationsSecurityMonitoringConditionsListCall) IfNoneMatch(entityTag string) *OrganizationsSecurityMonitoringConditionsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsSecurityMonitoringConditionsListCall) Context(ctx context.Context) *OrganizationsSecurityMonitoringConditionsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsSecurityMonitoringConditionsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsSecurityMonitoringConditionsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/securityMonitoringConditions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.securityMonitoringConditions.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse.ServerResponse.H +// eader or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *OrganizationsSecurityMonitoringConditionsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *OrganizationsSecurityMonitoringConditionsListCall) Pages(ctx context.Context, f func(*GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type OrganizationsSecurityMonitoringConditionsPatchCall struct { + s *Service + name string + googlecloudapigeev1securitymonitoringcondition *GoogleCloudApigeeV1SecurityMonitoringCondition + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a security monitoring condition. +// +// - name: Identifier. Name of the security monitoring condition resource. +// Format: +// organizations/{org}/securityMonitoringConditions/{security_monitoring_condi +// tion}. +func (r *OrganizationsSecurityMonitoringConditionsService) Patch(name string, googlecloudapigeev1securitymonitoringcondition *GoogleCloudApigeeV1SecurityMonitoringCondition) *OrganizationsSecurityMonitoringConditionsPatchCall { + c := &OrganizationsSecurityMonitoringConditionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudapigeev1securitymonitoringcondition = googlecloudapigeev1securitymonitoringcondition + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Valid fields to update are `profile`, `scope`, +// `include_all_resources`, `include`, and `exclude`. +func (c *OrganizationsSecurityMonitoringConditionsPatchCall) UpdateMask(updateMask string) *OrganizationsSecurityMonitoringConditionsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsSecurityMonitoringConditionsPatchCall) Fields(s ...googleapi.Field) *OrganizationsSecurityMonitoringConditionsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsSecurityMonitoringConditionsPatchCall) Context(ctx context.Context) *OrganizationsSecurityMonitoringConditionsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsSecurityMonitoringConditionsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsSecurityMonitoringConditionsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudapigeev1securitymonitoringcondition) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "apigee.organizations.securityMonitoringConditions.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudApigeeV1SecurityMonitoringCondition.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsSecurityMonitoringConditionsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1SecurityMonitoringCondition, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudApigeeV1SecurityMonitoringCondition{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "apigee.organizations.securityMonitoringConditions.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type OrganizationsSecurityProfilesCreateCall struct { s *Service parent string diff --git a/appengine/v1/appengine-api.json b/appengine/v1/appengine-api.json index 65811387d4..fc21004faa 100644 --- a/appengine/v1/appengine-api.json +++ b/appengine/v1/appengine-api.json @@ -1655,6 +1655,55 @@ "locations": { "resources": { "applications": { + "methods": { + "patch": { + "description": "Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/applications/{applicationsId}", + "httpMethod": "PATCH", + "id": "appengine.projects.locations.applications.patch", + "parameterOrder": [ + "projectsId", + "locationsId", + "applicationsId" + ], + "parameters": { + "applicationsId": { + "description": "Part of `name`. See documentation of `projectsId`.", + "location": "path", + "required": true, + "type": "string" + }, + "locationsId": { + "description": "Part of `name`. See documentation of `projectsId`.", + "location": "path", + "required": true, + "type": "string" + }, + "projectsId": { + "description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Standard field mask for the set of fields to be updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/projects/{projectsId}/locations/{locationsId}/applications/{applicationsId}", + "request": { + "$ref": "Application" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "authorizedDomains": { "methods": { @@ -1825,7 +1874,7 @@ } } }, - "revision": "20250223", + "revision": "20250310", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { diff --git a/appengine/v1/appengine-gen.go b/appengine/v1/appengine-gen.go index 2fd869cc2b..1e52a147b0 100644 --- a/appengine/v1/appengine-gen.go +++ b/appengine/v1/appengine-gen.go @@ -8506,6 +8506,129 @@ func (c *AppsServicesVersionsInstancesListCall) Pages(ctx context.Context, f fun } } +type ProjectsLocationsApplicationsPatchCall struct { + s *APIService + projectsId string + locationsId string + applicationsId string + application *Application + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the specified Application resource. You can update the +// following fields: auth_domain - Google authentication domain for controlling +// user access to the application. default_cookie_expiration - Cookie +// expiration policy for the application. iap - Identity-Aware Proxy properties +// for the application. +// +// - applicationsId: Part of `name`. See documentation of `projectsId`. +// - locationsId: Part of `name`. See documentation of `projectsId`. +// - projectsId: Part of `name`. Name of the Application resource to update. +// Example: apps/myapp. +func (r *ProjectsLocationsApplicationsService) Patch(projectsId string, locationsId string, applicationsId string, application *Application) *ProjectsLocationsApplicationsPatchCall { + c := &ProjectsLocationsApplicationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.projectsId = projectsId + c.locationsId = locationsId + c.applicationsId = applicationsId + c.application = application + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Standard +// field mask for the set of fields to be updated. +func (c *ProjectsLocationsApplicationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsApplicationsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsApplicationsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsApplicationsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsApplicationsPatchCall) Context(ctx context.Context) *ProjectsLocationsApplicationsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsApplicationsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsApplicationsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.application) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/projects/{projectsId}/locations/{locationsId}/applications/{applicationsId}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "projectsId": c.projectsId, + "locationsId": c.locationsId, + "applicationsId": c.applicationsId, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "appengine.projects.locations.applications.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "appengine.projects.locations.applications.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsApplicationsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "appengine.projects.locations.applications.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsApplicationsAuthorizedDomainsListCall struct { s *APIService projectsId string diff --git a/appengine/v1beta/appengine-api.json b/appengine/v1beta/appengine-api.json index cfcafd26ba..9c34c13e2e 100644 --- a/appengine/v1beta/appengine-api.json +++ b/appengine/v1beta/appengine-api.json @@ -1762,6 +1762,55 @@ }, "resources": { "applications": { + "methods": { + "patch": { + "description": "Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/applications/{applicationsId}", + "httpMethod": "PATCH", + "id": "appengine.projects.locations.applications.patch", + "parameterOrder": [ + "projectsId", + "locationsId", + "applicationsId" + ], + "parameters": { + "applicationsId": { + "description": "Part of `name`. See documentation of `projectsId`.", + "location": "path", + "required": true, + "type": "string" + }, + "locationsId": { + "description": "Part of `name`. See documentation of `projectsId`.", + "location": "path", + "required": true, + "type": "string" + }, + "projectsId": { + "description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Standard field mask for the set of fields to be updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta/projects/{projectsId}/locations/{locationsId}/applications/{applicationsId}", + "request": { + "$ref": "Application" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "authorizedDomains": { "methods": { @@ -2025,7 +2074,7 @@ } } }, - "revision": "20250223", + "revision": "20250310", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index 2a18c73910..882dcf8950 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -8901,6 +8901,129 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } +type ProjectsLocationsApplicationsPatchCall struct { + s *APIService + projectsId string + locationsId string + applicationsId string + application *Application + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the specified Application resource. You can update the +// following fields: auth_domain - Google authentication domain for controlling +// user access to the application. default_cookie_expiration - Cookie +// expiration policy for the application. iap - Identity-Aware Proxy properties +// for the application. +// +// - applicationsId: Part of `name`. See documentation of `projectsId`. +// - locationsId: Part of `name`. See documentation of `projectsId`. +// - projectsId: Part of `name`. Name of the Application resource to update. +// Example: apps/myapp. +func (r *ProjectsLocationsApplicationsService) Patch(projectsId string, locationsId string, applicationsId string, application *Application) *ProjectsLocationsApplicationsPatchCall { + c := &ProjectsLocationsApplicationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.projectsId = projectsId + c.locationsId = locationsId + c.applicationsId = applicationsId + c.application = application + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Standard +// field mask for the set of fields to be updated. +func (c *ProjectsLocationsApplicationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsApplicationsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsApplicationsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsApplicationsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsApplicationsPatchCall) Context(ctx context.Context) *ProjectsLocationsApplicationsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsApplicationsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsApplicationsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.application) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/projects/{projectsId}/locations/{locationsId}/applications/{applicationsId}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "projectsId": c.projectsId, + "locationsId": c.locationsId, + "applicationsId": c.applicationsId, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "appengine.projects.locations.applications.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "appengine.projects.locations.applications.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsApplicationsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "appengine.projects.locations.applications.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsApplicationsAuthorizedDomainsListCall struct { s *APIService projectsId string diff --git a/backupdr/v1/backupdr-api.json b/backupdr/v1/backupdr-api.json index eafbd45a5c..6496a3b911 100644 --- a/backupdr/v1/backupdr-api.json +++ b/backupdr/v1/backupdr-api.json @@ -1745,7 +1745,7 @@ } } }, - "revision": "20250205", + "revision": "20250305", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -2462,6 +2462,12 @@ "format": "google-datetime", "readOnly": true, "type": "string" + }, + "lastSuccessfulLogBackupConsistencyTime": { + "description": "Output only. If the last log backup were successful, this field has the consistency date.", + "format": "google-datetime", + "readOnly": true, + "type": "string" } }, "type": "object" diff --git a/backupdr/v1/backupdr-gen.go b/backupdr/v1/backupdr-gen.go index bd2da745b4..2bf97d29c7 100644 --- a/backupdr/v1/backupdr-gen.go +++ b/backupdr/v1/backupdr-gen.go @@ -975,6 +975,9 @@ type BackupConfigInfo struct { // LastSuccessfulBackupConsistencyTime: Output only. If the last backup were // successful, this field has the consistency date. LastSuccessfulBackupConsistencyTime string `json:"lastSuccessfulBackupConsistencyTime,omitempty"` + // LastSuccessfulLogBackupConsistencyTime: Output only. If the last log backup + // were successful, this field has the consistency date. + LastSuccessfulLogBackupConsistencyTime string `json:"lastSuccessfulLogBackupConsistencyTime,omitempty"` // ForceSendFields is a list of field names (e.g. // "BackupApplianceBackupConfig") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API diff --git a/beyondcorp/v1/beyondcorp-api.json b/beyondcorp/v1/beyondcorp-api.json index 66b54100bb..a190ee020f 100644 --- a/beyondcorp/v1/beyondcorp-api.json +++ b/beyondcorp/v1/beyondcorp-api.json @@ -113,65 +113,6 @@ "resources": { "partnerTenants": { "methods": { - "getIamPolicy": { - "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}:getIamPolicy", - "httpMethod": "GET", - "id": "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}:testIamPermissions", @@ -204,65 +145,6 @@ "resources": { "browserDlpRules": { "methods": { - "getIamPolicy": { - "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules/{browserDlpRulesId}:getIamPolicy", - "httpMethod": "GET", - "id": "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/browserDlpRules/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules/{browserDlpRulesId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/browserDlpRules/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules/{browserDlpRulesId}:testIamPermissions", @@ -295,65 +177,6 @@ }, "proxyConfigs": { "methods": { - "getIamPolicy": { - "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}:getIamPolicy", - "httpMethod": "GET", - "id": "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/proxyConfigs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/proxyConfigs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}:testIamPermissions", @@ -1656,34 +1479,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clientGateways/{clientGatewaysId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.projects.locations.clientGateways.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/clientGateways/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clientGateways/{clientGatewaysId}:testIamPermissions", @@ -2404,7 +2199,7 @@ } } }, - "revision": "20250219", + "revision": "20250305", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { diff --git a/beyondcorp/v1/beyondcorp-gen.go b/beyondcorp/v1/beyondcorp-gen.go index 2f5a1c0da8..a3ac7d24e0 100644 --- a/beyondcorp/v1/beyondcorp-gen.go +++ b/beyondcorp/v1/beyondcorp-gen.go @@ -2681,783 +2681,66 @@ func (s Tunnelv1ProtoTunnelerInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. -// -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. If the resource does not exist, this will return an empty set of -// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be -// used for building permission-aware UIs and command-line tools, not for -// authorization checking. This operation may "fail open" without warning. -// -// - resource: REQUIRED: The resource for which the policy detail is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the appropriate -// value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall { - c := &OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.testIamPermissions" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1TestIamPermissionsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.testIamPermissions", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. -// -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. If the resource does not exist, this will return an empty set of -// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be -// used for building permission-aware UIs and command-line tools, not for -// authorization checking. This operation may "fail open" without warning. -// -// - resource: REQUIRED: The resource for which the policy detail is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the appropriate -// value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall { - c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.testIamPermissions" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1TestIamPermissionsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.testIamPermissions", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. // -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *OrganizationsLocationsGlobalPartnerTenantsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall { + c := &OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Header() http.Header { +func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -3465,17 +2748,17 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) googleapi.Expand(req.URL, map[string]string{ "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy" call. +// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.testIamPermissions" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -3494,7 +2777,7 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -3505,65 +2788,68 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.testIamPermissions", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. // -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall { + c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Header() http.Header { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1testiampermissionsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -3573,17 +2859,17 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) googleapi.Expand(req.URL, map[string]string{ "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy" call. +// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.testIamPermissions" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -3602,7 +2888,7 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -3613,7 +2899,7 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.testIamPermissions", "response", internallog.HTTPResponse(res, b)) return ret, nil } @@ -8393,114 +7679,6 @@ func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Do(opts ...googleapi.C return ret, nil } -type ProjectsLocationsClientGatewaysSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsClientGatewaysService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsClientGatewaysSetIamPolicyCall { - c := &ProjectsLocationsClientGatewaysSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsClientGatewaysSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsClientGatewaysSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.projects.locations.clientGateways.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type ProjectsLocationsClientGatewaysTestIamPermissionsCall struct { s *Service resource string diff --git a/beyondcorp/v1alpha/beyondcorp-api.json b/beyondcorp/v1alpha/beyondcorp-api.json index 4cf1a2bfdb..d52d035cb2 100644 --- a/beyondcorp/v1alpha/beyondcorp-api.json +++ b/beyondcorp/v1alpha/beyondcorp-api.json @@ -114,6 +114,7 @@ "partnerTenants": { "methods": { "create": { + "deprecated": true, "description": "Creates a new BeyondCorp Enterprise partnerTenant in a given organization and can only be called by onboarded BeyondCorp Enterprise partner.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants", "httpMethod": "POST", @@ -147,6 +148,7 @@ ] }, "delete": { + "deprecated": true, "description": "Deletes a single PartnerTenant.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}", "httpMethod": "DELETE", @@ -201,37 +203,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "getIamPolicy": { - "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}:getIamPolicy", - "httpMethod": "GET", - "id": "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "list": { "description": "Lists PartnerTenants in a given organization.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants", @@ -279,6 +250,7 @@ ] }, "patch": { + "deprecated": true, "description": "Updates a single PartnerTenant.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}", "httpMethod": "PATCH", @@ -317,34 +289,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}:testIamPermissions", @@ -465,37 +409,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "getIamPolicy": { - "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules/{browserDlpRulesId}:getIamPolicy", - "httpMethod": "GET", - "id": "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/browserDlpRules/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "list": { "description": "Lists BrowserDlpRules for PartnerTenant in a given organization.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules", @@ -560,34 +473,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules/{browserDlpRulesId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/browserDlpRules/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/browserDlpRules/{browserDlpRulesId}:testIamPermissions", @@ -621,6 +506,7 @@ "proxyConfigs": { "methods": { "create": { + "deprecated": true, "description": "Creates a new BeyondCorp Enterprise ProxyConfig in a given organization and PartnerTenant. Can only be called by on onboarded Beyondcorp Enterprise partner.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs", "httpMethod": "POST", @@ -654,6 +540,7 @@ ] }, "delete": { + "deprecated": true, "description": "Deletes a single ProxyConfig.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}", "httpMethod": "DELETE", @@ -684,6 +571,7 @@ ] }, "get": { + "deprecated": true, "description": "Gets details of a single ProxyConfig.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}", "httpMethod": "GET", @@ -708,38 +596,8 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "getIamPolicy": { - "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}:getIamPolicy", - "httpMethod": "GET", - "id": "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/proxyConfigs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "list": { + "deprecated": true, "description": "Lists ProxyConfigs for PartnerTenant in a given organization.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs", "httpMethod": "GET", @@ -786,6 +644,7 @@ ] }, "patch": { + "deprecated": true, "description": "Updates a single proxy config.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}", "httpMethod": "PATCH", @@ -824,34 +683,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^organizations/[^/]+/locations/global/partnerTenants/[^/]+/proxyConfigs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/partnerTenants/{partnerTenantsId}/proxyConfigs/{proxyConfigsId}:testIamPermissions", @@ -2738,34 +2569,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", - "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/clientGateways/{clientGatewaysId}:setIamPolicy", - "httpMethod": "POST", - "id": "beyondcorp.projects.locations.clientGateways.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/clientGateways/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/clientGateways/{clientGatewaysId}:testIamPermissions", @@ -3095,34 +2898,6 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] - }, - "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", - "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}:testIamPermissions", - "httpMethod": "POST", - "id": "beyondcorp.projects.locations.connections.testIamPermissions", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:testIamPermissions", - "request": { - "$ref": "GoogleIamV1TestIamPermissionsRequest" - }, - "response": { - "$ref": "GoogleIamV1TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] } } }, @@ -3432,34 +3207,6 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] - }, - "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", - "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/connectors/{connectorsId}:testIamPermissions", - "httpMethod": "POST", - "id": "beyondcorp.projects.locations.connectors.testIamPermissions", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/connectors/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha/{+resource}:testIamPermissions", - "request": { - "$ref": "GoogleIamV1TestIamPermissionsRequest" - }, - "response": { - "$ref": "GoogleIamV1TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] } } }, @@ -4381,7 +4128,7 @@ } } }, - "revision": "20250219", + "revision": "20250305", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { diff --git a/beyondcorp/v1alpha/beyondcorp-gen.go b/beyondcorp/v1alpha/beyondcorp-gen.go index f152e85823..b6f23ea9ba 100644 --- a/beyondcorp/v1alpha/beyondcorp-gen.go +++ b/beyondcorp/v1alpha/beyondcorp-gen.go @@ -4505,136 +4505,6 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsGetCall) Do(opts ...googleapi return ret, nil } -type OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. -// -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.getIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type OrganizationsLocationsGlobalPartnerTenantsListCall struct { s *Service parent string @@ -4941,114 +4811,6 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsPatchCall) Do(opts ...googlea return ret, nil } -type OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type OrganizationsLocationsGlobalPartnerTenantsTestIamPermissionsCall struct { s *Service resource string @@ -5511,48 +5273,31 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetCall) Do(op return ret, nil } -type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall struct { +type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall struct { s *Service - resource string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. +// List: Lists BrowserDlpRules for PartnerTenant in a given organization. // -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// - parent: The parent partnerTenant to which the BrowserDlpRules belong. +// Format: +// `organizations/{organization_id}/locations/global/partnerTenants/{partner_t +// enant_id}`. +func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) List(parent string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { + c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5560,34 +5305,34 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCa // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Header() http.Header { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/browserDlpRules") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -5595,120 +5340,7 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCa } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.getIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists BrowserDlpRules for PartnerTenant in a given organization. -// -// - parent: The parent partnerTenant to which the BrowserDlpRules belong. -// Format: -// `organizations/{organization_id}/locations/global/partnerTenants/{partner_t -// enant_id}`. -func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) List(parent string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { - c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/browserDlpRules") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "parent": c.parent, }) c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) @@ -5883,114 +5515,6 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesPatchCall) Do( return ret, nil } -type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.browserDlpRules.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type OrganizationsLocationsGlobalPartnerTenantsBrowserDlpRulesTestIamPermissionsCall struct { s *Service resource string @@ -6354,148 +5878,16 @@ type OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall struct { // - name: The resource name of the ProxyConfig using the form: // `organizations/{organization_id}/locations/global/partnerTenants/{partner_t // enant_id}/proxyConfigs/{proxy_config_id}`. -func (r *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsService) Get(name string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { - c := &OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig.ServerResponse.Header -// -// or (if a response was returned at all) in error.(*googleapi.Error).Header. -// -// Use googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. -// -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +func (r *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsService) Get(name string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { + c := &OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -6503,34 +5895,34 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall { +func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Header() http.Header { +func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -6538,19 +5930,21 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy" call. +// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig.ServerResponse.Header +// +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6569,7 +5963,7 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6580,7 +5974,7 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsGetIamPolicyCall) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } @@ -6887,114 +6281,6 @@ func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsPatchCall) Do(opt return ret, nil } -type OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall { - c := &OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *OrganizationsLocationsGlobalPartnerTenantsProxyConfigsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.organizations.locations.global.partnerTenants.proxyConfigs.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type OrganizationsLocationsGlobalPartnerTenantsProxyConfigsTestIamPermissionsCall struct { s *Service resource string @@ -13697,188 +12983,80 @@ type ProjectsLocationsClientGatewaysGetIamPolicyCall struct { resource string urlParams_ gensupport.URLParams ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. -// -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsClientGatewaysService) GetIamPolicy(resource string) *ProjectsLocationsClientGatewaysGetIamPolicyCall { - c := &ProjectsLocationsClientGatewaysGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsClientGatewaysGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsClientGatewaysGetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsClientGatewaysGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsClientGatewaysGetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.projects.locations.clientGateways.getIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.getIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsClientGatewaysSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. +// GetIamPolicy: Gets the access control policy for a resource. Returns an +// empty policy if the resource exists and does not have a policy set. // -// - resource: REQUIRED: The resource for which the policy is being specified. +// - resource: REQUIRED: The resource for which the policy is being requested. // See Resource names (https://cloud.google.com/apis/design/resource_names) // for the appropriate value for this field. -func (r *ProjectsLocationsClientGatewaysService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsClientGatewaysSetIamPolicyCall { - c := &ProjectsLocationsClientGatewaysSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsClientGatewaysService) GetIamPolicy(resource string) *ProjectsLocationsClientGatewaysGetIamPolicyCall { + c := &ProjectsLocationsClientGatewaysGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsClientGatewaysGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsClientGatewaysSetIamPolicyCall { +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsClientGatewaysGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsClientGatewaysGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsClientGatewaysSetIamPolicyCall { +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsClientGatewaysGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -13886,17 +13064,17 @@ func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) doRequest(alt string) googleapi.Expand(req.URL, map[string]string{ "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.clientGateways.setIamPolicy" call. +// Do executes the "beyondcorp.projects.locations.clientGateways.getIamPolicy" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to // check whether the returned error was because http.StatusNotModified was // returned. -func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsClientGatewaysGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -13926,7 +13104,7 @@ func (c *ProjectsLocationsClientGatewaysSetIamPolicyCall) Do(opts ...googleapi.C if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.clientGateways.getIamPolicy", "response", internallog.HTTPResponse(res, b)) return ret, nil } @@ -15119,117 +14297,6 @@ func (c *ProjectsLocationsConnectionsSetIamPolicyCall) Do(opts ...googleapi.Call return ret, nil } -type ProjectsLocationsConnectionsTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. If the resource does not exist, this will return an empty set of -// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be -// used for building permission-aware UIs and command-line tools, not for -// authorization checking. This operation may "fail open" without warning. -// -// - resource: REQUIRED: The resource for which the policy detail is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the appropriate -// value for this field. -func (r *ProjectsLocationsConnectionsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsConnectionsTestIamPermissionsCall { - c := &ProjectsLocationsConnectionsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsConnectionsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsConnectionsTestIamPermissionsCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsConnectionsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsConnectionsTestIamPermissionsCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsConnectionsTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsConnectionsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.connections.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.projects.locations.connections.testIamPermissions" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsConnectionsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1TestIamPermissionsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.connections.testIamPermissions", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type ProjectsLocationsConnectorsCreateCall struct { s *Service parent string @@ -16358,117 +15425,6 @@ func (c *ProjectsLocationsConnectorsSetIamPolicyCall) Do(opts ...googleapi.CallO return ret, nil } -type ProjectsLocationsConnectorsTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. If the resource does not exist, this will return an empty set of -// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be -// used for building permission-aware UIs and command-line tools, not for -// authorization checking. This operation may "fail open" without warning. -// -// - resource: REQUIRED: The resource for which the policy detail is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the appropriate -// value for this field. -func (r *ProjectsLocationsConnectorsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsConnectorsTestIamPermissionsCall { - c := &ProjectsLocationsConnectorsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsConnectorsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsConnectorsTestIamPermissionsCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsConnectorsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsConnectorsTestIamPermissionsCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsConnectorsTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsConnectorsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.connectors.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "beyondcorp.projects.locations.connectors.testIamPermissions" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsConnectorsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1TestIamPermissionsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "beyondcorp.projects.locations.connectors.testIamPermissions", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall struct { s *Service parent string diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index e8bc424110..844aa035c9 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -2256,7 +2256,7 @@ } } }, - "revision": "20250216", + "revision": "20250313", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3375,6 +3375,13 @@ "description": "Optional. Specifies a string that represents a null value in a CSV file. For example, if you specify \"\\N\", BigQuery interprets \"\\N\" as a null value when querying a CSV file. The default value is the empty string. If you set this property to a custom value, BigQuery throws an error if an empty string is present for all data types except for STRING and BYTE. For STRING and BYTE columns, BigQuery interprets the empty string as an empty value.", "type": "string" }, + "nullMarkers": { + "description": "Optional. A list of strings represented as SQL NULL value in a CSV file. null_marker and null_markers can't be set at the same time. If null_marker is set, null_markers has to be not set. If null_markers is set, null_marker has to be not set. If both null_marker and null_markers are set at the same time, a user error would be thrown. Any strings listed in null_markers, including empty string would be interpreted as SQL NULL. This applies to all column types.", + "items": { + "type": "string" + }, + "type": "array" + }, "preserveAsciiControlCharacters": { "description": "Optional. Indicates if the embedded ASCII control characters (the first 32 characters in the ASCII-table, from '\\x00' to '\\x1F') are preserved.", "type": "boolean" @@ -3389,6 +3396,10 @@ "description": "Optional. The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. When autodetect is on, the behavior is the following: * skipLeadingRows unspecified - Autodetect tries to detect headers in the first row. If they are not detected, the row is read as data. Otherwise data is read starting from the second row. * skipLeadingRows is 0 - Instructs autodetect that there are no headers and data should be read starting from the first row. * skipLeadingRows = N \u003e 0 - Autodetect skips N-1 rows and tries to detect headers in row N. If headers are not detected, row N is just skipped. Otherwise row N is used to extract column names for the detected schema.", "format": "int64", "type": "string" + }, + "sourceColumnMatch": { + "description": "Optional. Controls the strategy used to match loaded columns to the schema. If not set, a sensible default is chosen based on how the schema is provided. If autodetect is used, then columns are matched by name. Otherwise, columns are matched by position. This is done to keep the behavior backward-compatible. Acceptable values are: POSITION - matches by position. This assumes that the columns are ordered the same way as the schema. NAME - matches by name. This reads the header row as column names and reorders columns to match the field names in the schema.", + "type": "string" } }, "type": "object" @@ -5270,6 +5281,10 @@ "query": { "$ref": "JobConfigurationQuery", "description": "[Pick one] Configures a query job." + }, + "reservation": { + "description": "Optional. The reservation that job would use. User can specify a reservation to execute the job. If reservation is not set, reservation is determined based on the rules defined by the reservation assignments. The expected format is `projects/{project}/locations/{location}/reservations/{reservation}`.", + "type": "string" } }, "type": "object" @@ -5468,6 +5483,13 @@ "description": "Optional. Specifies a string that represents a null value in a CSV file. For example, if you specify \"\\N\", BigQuery interprets \"\\N\" as a null value when loading a CSV file. The default value is the empty string. If you set this property to a custom value, BigQuery throws an error if an empty string is present for all data types except for STRING and BYTE. For STRING and BYTE columns, BigQuery interprets the empty string as an empty value.", "type": "string" }, + "nullMarkers": { + "description": "Optional. A list of strings represented as SQL NULL value in a CSV file. null_marker and null_markers can't be set at the same time. If null_marker is set, null_markers has to be not set. If null_markers is set, null_marker has to be not set. If both null_marker and null_markers are set at the same time, a user error would be thrown. Any strings listed in null_markers, including empty string would be interpreted as SQL NULL. This applies to all column types.", + "items": { + "type": "string" + }, + "type": "array" + }, "parquetOptions": { "$ref": "ParquetOptions", "description": "Optional. Additional properties to set if sourceFormat is set to PARQUET." @@ -5521,6 +5543,20 @@ "format": "int32", "type": "integer" }, + "sourceColumnMatch": { + "description": "Optional. Controls the strategy used to match loaded columns to the schema. If not set, a sensible default is chosen based on how the schema is provided. If autodetect is used, then columns are matched by name. Otherwise, columns are matched by position. This is done to keep the behavior backward-compatible.", + "enum": [ + "SOURCE_COLUMN_MATCH_UNSPECIFIED", + "POSITION", + "NAME" + ], + "enumDescriptions": [ + "Uses sensible defaults based on how the schema is provided. If autodetect is used, then columns are matched by name. Otherwise, columns are matched by position. This is done to keep the behavior backward-compatible.", + "Matches by position. This assumes that the columns are ordered the same way as the schema.", + "Matches by name. This reads the header row as column names and reorders columns to match the field names in the schema." + ], + "type": "string" + }, "sourceFormat": { "description": "Optional. The format of the data files. For CSV files, specify \"CSV\". For datastore backups, specify \"DATASTORE_BACKUP\". For newline-delimited JSON, specify \"NEWLINE_DELIMITED_JSON\". For Avro, specify \"AVRO\". For parquet, specify \"PARQUET\". For orc, specify \"ORC\". The default value is CSV.", "type": "string" @@ -7574,6 +7610,10 @@ "description": "Optional. A unique user provided identifier to ensure idempotent behavior for queries. Note that this is different from the job_id. It has the following properties: 1. It is case-sensitive, limited to up to 36 ASCII characters. A UUID is recommended. 2. Read only queries can ignore this token since they are nullipotent by definition. 3. For the purposes of idempotency ensured by the request_id, a request is considered duplicate of another only if they have the same request_id and are actually duplicates. When determining whether a request is a duplicate of another request, all parameters in the request that may affect the result are considered. For example, query, connection_properties, query_parameters, use_legacy_sql are parameters that affect the result and are considered when determining whether a request is a duplicate, but properties like timeout_ms don't affect the result and are thus not considered. Dry run query requests are never considered duplicate of another request. 4. When a duplicate mutating query request is detected, it returns: a. the results of the mutation if it completes successfully within the timeout. b. the running operation if it is still in progress at the end of the timeout. 5. Its lifetime is limited to 15 minutes. In other words, if two requests are sent with the same request_id, but more than 15 minutes apart, idempotency is not guaranteed.", "type": "string" }, + "reservation": { + "description": "Optional. The reservation that jobs.query request would use. User can specify a reservation to execute the job.query. The expected format is `projects/{project}/locations/{location}/reservations/{reservation}`.", + "type": "string" + }, "timeoutMs": { "description": "Optional. Optional: Specifies the maximum amount of time, in milliseconds, that the client is willing to wait for the query to complete. By default, this limit is 10 seconds (10,000 milliseconds). If the query is complete, the jobComplete field in the response is true. If the query has not yet completed, jobComplete is false. You can request a longer timeout period in the timeoutMs field. However, the call is not guaranteed to wait for the specified timeout; it typically returns after around 200 seconds (200,000 milliseconds), even if the query is not complete. If jobComplete is false, you can continue to wait for the query to complete by calling the getQueryResults method until the jobComplete field in the getQueryResults response is true.", "format": "uint32", diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 39dc8a77ed..e8810506c4 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1837,6 +1837,14 @@ type CsvOptions struct { // STRING and BYTE columns, BigQuery interprets the empty string as an empty // value. NullMarker string `json:"nullMarker,omitempty"` + // NullMarkers: Optional. A list of strings represented as SQL NULL value in a + // CSV file. null_marker and null_markers can't be set at the same time. If + // null_marker is set, null_markers has to be not set. If null_markers is set, + // null_marker has to be not set. If both null_marker and null_markers are set + // at the same time, a user error would be thrown. Any strings listed in + // null_markers, including empty string would be interpreted as SQL NULL. This + // applies to all column types. + NullMarkers []string `json:"nullMarkers,omitempty"` // PreserveAsciiControlCharacters: Optional. Indicates if the embedded ASCII // control characters (the first 32 characters in the ASCII-table, from '\x00' // to '\x1F') are preserved. @@ -1867,6 +1875,15 @@ type CsvOptions struct { // skipped. Otherwise row N is used to extract column names for the detected // schema. SkipLeadingRows int64 `json:"skipLeadingRows,omitempty,string"` + // SourceColumnMatch: Optional. Controls the strategy used to match loaded + // columns to the schema. If not set, a sensible default is chosen based on how + // the schema is provided. If autodetect is used, then columns are matched by + // name. Otherwise, columns are matched by position. This is done to keep the + // behavior backward-compatible. Acceptable values are: POSITION - matches by + // position. This assumes that the columns are ordered the same way as the + // schema. NAME - matches by name. This reads the header row as column names + // and reorders columns to match the field names in the schema. + SourceColumnMatch string `json:"sourceColumnMatch,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowJaggedRows") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4345,6 +4362,12 @@ type JobConfiguration struct { Load *JobConfigurationLoad `json:"load,omitempty"` // Query: [Pick one] Configures a query job. Query *JobConfigurationQuery `json:"query,omitempty"` + // Reservation: Optional. The reservation that job would use. User can specify + // a reservation to execute the job. If reservation is not set, reservation is + // determined based on the rules defined by the reservation assignments. The + // expected format is + // `projects/{project}/locations/{location}/reservations/{reservation}`. + Reservation string `json:"reservation,omitempty"` // ForceSendFields is a list of field names (e.g. "Copy") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -4596,6 +4619,14 @@ type JobConfigurationLoad struct { // STRING and BYTE columns, BigQuery interprets the empty string as an empty // value. NullMarker string `json:"nullMarker,omitempty"` + // NullMarkers: Optional. A list of strings represented as SQL NULL value in a + // CSV file. null_marker and null_markers can't be set at the same time. If + // null_marker is set, null_markers has to be not set. If null_markers is set, + // null_marker has to be not set. If both null_marker and null_markers are set + // at the same time, a user error would be thrown. Any strings listed in + // null_markers, including empty string would be interpreted as SQL NULL. This + // applies to all column types. + NullMarkers []string `json:"nullMarkers,omitempty"` // ParquetOptions: Optional. Additional properties to set if sourceFormat is // set to PARQUET. ParquetOptions *ParquetOptions `json:"parquetOptions,omitempty"` @@ -4666,6 +4697,22 @@ type JobConfigurationLoad struct { // skipped. Otherwise row N is used to extract column names for the detected // schema. SkipLeadingRows int64 `json:"skipLeadingRows,omitempty"` + // SourceColumnMatch: Optional. Controls the strategy used to match loaded + // columns to the schema. If not set, a sensible default is chosen based on how + // the schema is provided. If autodetect is used, then columns are matched by + // name. Otherwise, columns are matched by position. This is done to keep the + // behavior backward-compatible. + // + // Possible values: + // "SOURCE_COLUMN_MATCH_UNSPECIFIED" - Uses sensible defaults based on how + // the schema is provided. If autodetect is used, then columns are matched by + // name. Otherwise, columns are matched by position. This is done to keep the + // behavior backward-compatible. + // "POSITION" - Matches by position. This assumes that the columns are + // ordered the same way as the schema. + // "NAME" - Matches by name. This reads the header row as column names and + // reorders columns to match the field names in the schema. + SourceColumnMatch string `json:"sourceColumnMatch,omitempty"` // SourceFormat: Optional. The format of the data files. For CSV files, specify // "CSV". For datastore backups, specify "DATASTORE_BACKUP". For // newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". For Avro, specify @@ -7050,6 +7097,10 @@ type QueryRequest struct { // 15 minutes. In other words, if two requests are sent with the same // request_id, but more than 15 minutes apart, idempotency is not guaranteed. RequestId string `json:"requestId,omitempty"` + // Reservation: Optional. The reservation that jobs.query request would use. + // User can specify a reservation to execute the job.query. The expected format + // is `projects/{project}/locations/{location}/reservations/{reservation}`. + Reservation string `json:"reservation,omitempty"` // TimeoutMs: Optional. Optional: Specifies the maximum amount of time, in // milliseconds, that the client is willing to wait for the query to complete. // By default, this limit is 10 seconds (10,000 milliseconds). If the query is diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index e2838c4341..7f3b464666 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -935,7 +935,7 @@ } } }, - "revision": "20250304", + "revision": "20250316", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -1266,6 +1266,10 @@ "description": "The request for ReservationService.MergeCapacityCommitments.", "id": "MergeCapacityCommitmentsRequest", "properties": { + "capacityCommitmentId": { + "description": "Optional. The optional resulting capacity commitment ID. Capacity commitment name will be generated automatically if this field is empty. This field must only contain lower case alphanumeric characters or dashes. The first and last character cannot be a dash. Max length is 64 characters.", + "type": "string" + }, "capacityCommitmentIds": { "description": "Ids of capacity commitments to merge. These capacity commitments must exist under admin project and location specified in the parent. ID is the last portion of capacity commitment name e.g., 'abc' for projects/myproject/locations/US/capacityCommitments/abc", "items": { diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index fe06fc1c04..42fed3cb84 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -604,20 +604,26 @@ func (s ListReservationsResponse) MarshalJSON() ([]byte, error) { // MergeCapacityCommitmentsRequest: The request for // ReservationService.MergeCapacityCommitments. type MergeCapacityCommitmentsRequest struct { + // CapacityCommitmentId: Optional. The optional resulting capacity commitment + // ID. Capacity commitment name will be generated automatically if this field + // is empty. This field must only contain lower case alphanumeric characters or + // dashes. The first and last character cannot be a dash. Max length is 64 + // characters. + CapacityCommitmentId string `json:"capacityCommitmentId,omitempty"` // CapacityCommitmentIds: Ids of capacity commitments to merge. These capacity // commitments must exist under admin project and location specified in the // parent. ID is the last portion of capacity commitment name e.g., 'abc' for // projects/myproject/locations/US/capacityCommitments/abc CapacityCommitmentIds []string `json:"capacityCommitmentIds,omitempty"` - // ForceSendFields is a list of field names (e.g. "CapacityCommitmentIds") to + // ForceSendFields is a list of field names (e.g. "CapacityCommitmentId") 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. "CapacityCommitmentIds") 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. "CapacityCommitmentId") 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:"-"` } diff --git a/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index 314cd382c8..4d3baaeadb 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -2400,7 +2400,7 @@ } } }, - "revision": "20250227", + "revision": "20250308", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -3134,6 +3134,86 @@ }, "type": "object" }, + "CreateLogicalViewMetadata": { + "description": "The metadata for the Operation returned by CreateLogicalView.", + "id": "CreateLogicalViewMetadata", + "properties": { + "endTime": { + "description": "If set, the time at which this operation finished or was canceled.", + "format": "google-datetime", + "type": "string" + }, + "originalRequest": { + "$ref": "CreateLogicalViewRequest", + "description": "The request that prompted the initiation of this CreateLogicalView operation." + }, + "startTime": { + "description": "The time at which this operation started.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "CreateLogicalViewRequest": { + "description": "Request message for BigtableInstanceAdmin.CreateLogicalView.", + "id": "CreateLogicalViewRequest", + "properties": { + "logicalView": { + "$ref": "LogicalView", + "description": "Required. The logical view to create." + }, + "logicalViewId": { + "description": "Required. The ID to use for the logical view, which will become the final component of the logical view's resource name.", + "type": "string" + }, + "parent": { + "description": "Required. The parent instance where this logical view will be created. Format: `projects/{project}/instances/{instance}`.", + "type": "string" + } + }, + "type": "object" + }, + "CreateMaterializedViewMetadata": { + "description": "The metadata for the Operation returned by CreateMaterializedView.", + "id": "CreateMaterializedViewMetadata", + "properties": { + "endTime": { + "description": "If set, the time at which this operation finished or was canceled.", + "format": "google-datetime", + "type": "string" + }, + "originalRequest": { + "$ref": "CreateMaterializedViewRequest", + "description": "The request that prompted the initiation of this CreateMaterializedView operation." + }, + "startTime": { + "description": "The time at which this operation started.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "CreateMaterializedViewRequest": { + "description": "Request message for BigtableInstanceAdmin.CreateMaterializedView.", + "id": "CreateMaterializedViewRequest", + "properties": { + "materializedView": { + "$ref": "MaterializedView", + "description": "Required. The materialized view to create." + }, + "materializedViewId": { + "description": "Required. The ID to use for the materialized view, which will become the final component of the materialized view's resource name.", + "type": "string" + }, + "parent": { + "description": "Required. The parent instance where this materialized view will be created. Format: `projects/{project}/instances/{instance}`.", + "type": "string" + } + }, + "type": "object" + }, "CreateTableRequest": { "description": "Request message for google.bigtable.admin.v2.BigtableTableAdmin.CreateTable", "id": "CreateTableRequest", @@ -4044,6 +4124,48 @@ }, "type": "object" }, + "LogicalView": { + "description": "A SQL logical view object that can be referenced in SQL queries.", + "id": "LogicalView", + "properties": { + "etag": { + "description": "Optional. The etag for this logical view. This may be sent on update requests to ensure that the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag.", + "type": "string" + }, + "name": { + "description": "Identifier. The unique name of the logical view. Format: `projects/{project}/instances/{instance}/logicalViews/{logical_view}`", + "type": "string" + }, + "query": { + "description": "Required. The logical view's select query.", + "type": "string" + } + }, + "type": "object" + }, + "MaterializedView": { + "description": "A materialized view object that can be referenced in SQL queries.", + "id": "MaterializedView", + "properties": { + "deletionProtection": { + "description": "Set to true to make the MaterializedView protected against deletion.", + "type": "boolean" + }, + "etag": { + "description": "Optional. The etag for this materialized view. This may be sent on update requests to ensure that the client has an up-to-date value before proceeding. The server returns an ABORTED error on a mismatched etag.", + "type": "string" + }, + "name": { + "description": "Identifier. The unique name of the materialized view. Format: `projects/{project}/instances/{instance}/materializedViews/{materialized_view}`", + "type": "string" + }, + "query": { + "description": "Required. Immutable. The materialized view's select query.", + "type": "string" + } + }, + "type": "object" + }, "Modification": { "description": "A create, update, or delete of a particular column family.", "id": "Modification", @@ -4775,6 +4897,43 @@ }, "type": "object" }, + "UpdateLogicalViewMetadata": { + "description": "The metadata for the Operation returned by UpdateLogicalView.", + "id": "UpdateLogicalViewMetadata", + "properties": { + "endTime": { + "description": "If set, the time at which this operation finished or was canceled.", + "format": "google-datetime", + "type": "string" + }, + "originalRequest": { + "$ref": "UpdateLogicalViewRequest", + "description": "The request that prompted the initiation of this UpdateLogicalView operation." + }, + "startTime": { + "description": "The time at which this operation was started.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "UpdateLogicalViewRequest": { + "description": "Request message for BigtableInstanceAdmin.UpdateLogicalView.", + "id": "UpdateLogicalViewRequest", + "properties": { + "logicalView": { + "$ref": "LogicalView", + "description": "Required. The logical view to update. The logical view's `name` field is used to identify the view to update. Format: `projects/{project}/instances/{instance}/logicalViews/{logical_view}`." + }, + "updateMask": { + "description": "Optional. The list of fields to update.", + "format": "google-fieldmask", + "type": "string" + } + }, + "type": "object" + }, "UpdateTableMetadata": { "description": "Metadata type for the operation returned by UpdateTable.", "id": "UpdateTableMetadata", diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index d6b14d3e91..e7b40eaaa1 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -1472,6 +1472,120 @@ func (s CreateInstanceRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CreateLogicalViewMetadata: The metadata for the Operation returned by +// CreateLogicalView. +type CreateLogicalViewMetadata struct { + // EndTime: If set, the time at which this operation finished or was canceled. + EndTime string `json:"endTime,omitempty"` + // OriginalRequest: The request that prompted the initiation of this + // CreateLogicalView operation. + OriginalRequest *CreateLogicalViewRequest `json:"originalRequest,omitempty"` + // StartTime: The time at which this operation started. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") 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. "EndTime") 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 CreateLogicalViewMetadata) MarshalJSON() ([]byte, error) { + type NoMethod CreateLogicalViewMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CreateLogicalViewRequest: Request message for +// BigtableInstanceAdmin.CreateLogicalView. +type CreateLogicalViewRequest struct { + // LogicalView: Required. The logical view to create. + LogicalView *LogicalView `json:"logicalView,omitempty"` + // LogicalViewId: Required. The ID to use for the logical view, which will + // become the final component of the logical view's resource name. + LogicalViewId string `json:"logicalViewId,omitempty"` + // Parent: Required. The parent instance where this logical view will be + // created. Format: `projects/{project}/instances/{instance}`. + Parent string `json:"parent,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogicalView") 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. "LogicalView") 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 CreateLogicalViewRequest) MarshalJSON() ([]byte, error) { + type NoMethod CreateLogicalViewRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CreateMaterializedViewMetadata: The metadata for the Operation returned by +// CreateMaterializedView. +type CreateMaterializedViewMetadata struct { + // EndTime: If set, the time at which this operation finished or was canceled. + EndTime string `json:"endTime,omitempty"` + // OriginalRequest: The request that prompted the initiation of this + // CreateMaterializedView operation. + OriginalRequest *CreateMaterializedViewRequest `json:"originalRequest,omitempty"` + // StartTime: The time at which this operation started. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") 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. "EndTime") 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 CreateMaterializedViewMetadata) MarshalJSON() ([]byte, error) { + type NoMethod CreateMaterializedViewMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CreateMaterializedViewRequest: Request message for +// BigtableInstanceAdmin.CreateMaterializedView. +type CreateMaterializedViewRequest struct { + // MaterializedView: Required. The materialized view to create. + MaterializedView *MaterializedView `json:"materializedView,omitempty"` + // MaterializedViewId: Required. The ID to use for the materialized view, which + // will become the final component of the materialized view's resource name. + MaterializedViewId string `json:"materializedViewId,omitempty"` + // Parent: Required. The parent instance where this materialized view will be + // created. Format: `projects/{project}/instances/{instance}`. + Parent string `json:"parent,omitempty"` + // ForceSendFields is a list of field names (e.g. "MaterializedView") 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. "MaterializedView") 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 CreateMaterializedViewRequest) MarshalJSON() ([]byte, error) { + type NoMethod CreateMaterializedViewRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CreateTableRequest: Request message for // google.bigtable.admin.v2.BigtableTableAdmin.CreateTable type CreateTableRequest struct { @@ -2901,6 +3015,70 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LogicalView: A SQL logical view object that can be referenced in SQL +// queries. +type LogicalView struct { + // Etag: Optional. The etag for this logical view. This may be sent on update + // requests to ensure that the client has an up-to-date value before + // proceeding. The server returns an ABORTED error on a mismatched etag. + Etag string `json:"etag,omitempty"` + // Name: Identifier. The unique name of the logical view. Format: + // `projects/{project}/instances/{instance}/logicalViews/{logical_view}` + Name string `json:"name,omitempty"` + // Query: Required. The logical view's select query. + Query string `json:"query,omitempty"` + // ForceSendFields is a list of field names (e.g. "Etag") 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. "Etag") 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 LogicalView) MarshalJSON() ([]byte, error) { + type NoMethod LogicalView + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// MaterializedView: A materialized view object that can be referenced in SQL +// queries. +type MaterializedView struct { + // DeletionProtection: Set to true to make the MaterializedView protected + // against deletion. + DeletionProtection bool `json:"deletionProtection,omitempty"` + // Etag: Optional. The etag for this materialized view. This may be sent on + // update requests to ensure that the client has an up-to-date value before + // proceeding. The server returns an ABORTED error on a mismatched etag. + Etag string `json:"etag,omitempty"` + // Name: Identifier. The unique name of the materialized view. Format: + // `projects/{project}/instances/{instance}/materializedViews/{materialized_view + // }` + Name string `json:"name,omitempty"` + // Query: Required. Immutable. The materialized view's select query. + Query string `json:"query,omitempty"` + // ForceSendFields is a list of field names (e.g. "DeletionProtection") 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. "DeletionProtection") 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 MaterializedView) MarshalJSON() ([]byte, error) { + type NoMethod MaterializedView + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Modification: A create, update, or delete of a particular column family. type Modification struct { // Create: Create a new column family with the specified schema, or fail if one @@ -3987,6 +4165,61 @@ func (s UpdateInstanceMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UpdateLogicalViewMetadata: The metadata for the Operation returned by +// UpdateLogicalView. +type UpdateLogicalViewMetadata struct { + // EndTime: If set, the time at which this operation finished or was canceled. + EndTime string `json:"endTime,omitempty"` + // OriginalRequest: The request that prompted the initiation of this + // UpdateLogicalView operation. + OriginalRequest *UpdateLogicalViewRequest `json:"originalRequest,omitempty"` + // StartTime: The time at which this operation was started. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") 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. "EndTime") 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 UpdateLogicalViewMetadata) MarshalJSON() ([]byte, error) { + type NoMethod UpdateLogicalViewMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UpdateLogicalViewRequest: Request message for +// BigtableInstanceAdmin.UpdateLogicalView. +type UpdateLogicalViewRequest struct { + // LogicalView: Required. The logical view to update. The logical view's `name` + // field is used to identify the view to update. Format: + // `projects/{project}/instances/{instance}/logicalViews/{logical_view}`. + LogicalView *LogicalView `json:"logicalView,omitempty"` + // UpdateMask: Optional. The list of fields to update. + UpdateMask string `json:"updateMask,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogicalView") 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. "LogicalView") 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 UpdateLogicalViewRequest) MarshalJSON() ([]byte, error) { + type NoMethod UpdateLogicalViewRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // UpdateTableMetadata: Metadata type for the operation returned by // UpdateTable. type UpdateTableMetadata struct { diff --git a/binaryauthorization/v1/binaryauthorization-api.json b/binaryauthorization/v1/binaryauthorization-api.json index 82aed077bc..a3090da7f3 100644 --- a/binaryauthorization/v1/binaryauthorization-api.json +++ b/binaryauthorization/v1/binaryauthorization-api.json @@ -747,7 +747,7 @@ } } }, - "revision": "20250117", + "revision": "20250311", "rootUrl": "https://binaryauthorization.googleapis.com/", "schemas": { "AdmissionRule": { @@ -1820,6 +1820,10 @@ "description": "If true, require the image to be built from a top-level configuration. `trusted_source_repo_patterns` specifies the repositories containing this configuration.", "type": "boolean" }, + "customConstraints": { + "description": "Optional. A CEL expression for specifying custom constraints on the provenance payload. This can be used when users want to specify expectations on provenance fields that are not covered by the general check. For example, users can use this field to require that certain parameters should never be used during the build process.", + "type": "string" + }, "trustedBuilder": { "description": "Each verification rule is used for evaluation against provenances generated by a specific builder (group). For some of the builders, such as the Google Cloud Build, users don't need to explicitly specify their roots of trust in the policy since the evaluation service can automatically fetch them based on the builder (group).", "enum": [ diff --git a/binaryauthorization/v1/binaryauthorization-gen.go b/binaryauthorization/v1/binaryauthorization-gen.go index 0d9f11b482..289444f935 100644 --- a/binaryauthorization/v1/binaryauthorization-gen.go +++ b/binaryauthorization/v1/binaryauthorization-gen.go @@ -2016,6 +2016,12 @@ type VerificationRule struct { // top-level configuration. `trusted_source_repo_patterns` specifies the // repositories containing this configuration. ConfigBasedBuildRequired bool `json:"configBasedBuildRequired,omitempty"` + // CustomConstraints: Optional. A CEL expression for specifying custom + // constraints on the provenance payload. This can be used when users want to + // specify expectations on provenance fields that are not covered by the + // general check. For example, users can use this field to require that certain + // parameters should never be used during the build process. + CustomConstraints string `json:"customConstraints,omitempty"` // TrustedBuilder: Each verification rule is used for evaluation against // provenances generated by a specific builder (group). For some of the // builders, such as the Google Cloud Build, users don't need to explicitly diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 0dbf295f38..0cd8bc8aa8 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -321,7 +321,7 @@ ] }, "delete": { - "description": "Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) You can authenticate and authorize this method with administrator privileges by setting the `use_admin_access` field in the request.", + "description": "Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - Developer Preview: [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth). Requires that the Chat app created the space using app authentication. - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) You can authenticate and authorize this method with administrator privileges by setting the `use_admin_access` field in the request.", "flatPath": "v1/spaces/{spacesId}", "httpMethod": "DELETE", "id": "chat.spaces.delete", @@ -720,7 +720,7 @@ ] }, "patch": { - "description": "Updates a membership. For an example, see [Update a user's membership in a space](https://developers.google.com/workspace/chat/update-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) You can authenticate and authorize this method with administrator privileges by setting the `use_admin_access` field in the request.", + "description": "Updates a membership. For an example, see [Update a user's membership in a space](https://developers.google.com/workspace/chat/update-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - Developer Preview: [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth). Requires that the Chat app created the space using app authentication. - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) You can authenticate and authorize this method with administrator privileges by setting the `use_admin_access` field in the request.", "flatPath": "v1/spaces/{spacesId}/members/{membersId}", "httpMethod": "PATCH", "id": "chat.spaces.members.patch", @@ -1315,7 +1315,7 @@ "spaceNotificationSetting": { "methods": { "get": { - "description": "Gets the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Gets the space notification setting. For an example, see [Get the caller's space notification setting](https://developers.google.com/workspace/chat/get-space-notification-setting). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/users/{usersId}/spaces/{spacesId}/spaceNotificationSetting", "httpMethod": "GET", "id": "chat.users.spaces.spaceNotificationSetting.get", @@ -1340,7 +1340,7 @@ ] }, "patch": { - "description": "Updates the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Updates the space notification setting. For an example, see [Update the caller's space notification setting](https://developers.google.com/workspace/chat/update-space-notification-setting). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/users/{usersId}/spaces/{spacesId}/spaceNotificationSetting", "httpMethod": "PATCH", "id": "chat.users.spaces.spaceNotificationSetting.patch", @@ -1410,7 +1410,7 @@ } } }, - "revision": "20250227", + "revision": "20250313", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 6c31e66c27..8e08c13159 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -6728,11 +6728,11 @@ type SpacesDeleteCall struct { // and memberships in the space—are also deleted. For an example, see Delete // a space (https://developers.google.com/workspace/chat/delete-spaces). // Supports the following types of authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize): - App -// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - +// Developer Preview: App authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// with administrator approval (https://support.google.com/a?p=chat-app-auth) -// in Developer Preview (https://developers.google.com/workspace/preview) - +// with administrator approval (https://support.google.com/a?p=chat-app-auth). +// Requires that the Chat app created the space using app authentication. - // User authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // You can authenticate and authorize this method with administrator privileges @@ -8458,11 +8458,11 @@ type SpacesMembersPatchCall struct { // Patch: Updates a membership. For an example, see Update a user's membership // in a space (https://developers.google.com/workspace/chat/update-members). // Supports the following types of authentication -// (https://developers.google.com/workspace/chat/authenticate-authorize): - App -// authentication +// (https://developers.google.com/workspace/chat/authenticate-authorize): - +// Developer Preview: App authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) -// with administrator approval (https://support.google.com/a?p=chat-app-auth) -// in Developer Preview (https://developers.google.com/workspace/preview) - +// with administrator approval (https://support.google.com/a?p=chat-app-auth). +// Requires that the Chat app created the space using app authentication. - // User authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // You can authenticate and authorize this method with administrator privileges @@ -10583,7 +10583,10 @@ type UsersSpacesSpaceNotificationSettingGetCall struct { header_ http.Header } -// Get: Gets the space notification state setting. Requires user authentication +// Get: Gets the space notification setting. For an example, see Get the +// caller's space notification setting +// (https://developers.google.com/workspace/chat/get-space-notification-setting). +// Requires user authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // // - name: Format: users/{user}/spaces/{space}/spaceNotificationSetting - @@ -10698,8 +10701,10 @@ type UsersSpacesSpaceNotificationSettingPatchCall struct { header_ http.Header } -// Patch: Updates the space notification state setting. Requires user -// authentication +// Patch: Updates the space notification setting. For an example, see Update +// the caller's space notification setting +// (https://developers.google.com/workspace/chat/update-space-notification-setting). +// Requires user authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // // - name: Identifier. The resource name of the space notification setting. diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 54f57e16c5..bc34926e36 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -413,12 +413,12 @@ ], "parameters": { "filter": { - "description": "Optional. The filter used to filter profiles. The following fields can be used in the filter: - profile_id - display_name - user_email - last_activity_time - last_policy_sync_time - last_status_report_time - first_enrollment_time - os_platform_type - os_version - browser_version - browser_channel - policy_count - extension_count - identity_provider - affiliation_state - ouId Any of the above fields can be used to specify a filter, and filtering by multiple fields is supported with AND operator. String type fields and enum type fields support '=' and '!=' operators. The integer type and the timestamp type fields support '=', '!=', '\u003c', '\u003e', '\u003c=' and '\u003e=' operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard '*' can be used with a string type field filter. In addition, string literal filtering is also supported, for example, 'ABC' as a filter maps to a filter that checks if any of the filterable string type fields contains 'ABC'. Organization unit number can be used as a filtering criteria here by specifying 'ouId = ${your_org_unit_id}', please note that only single OU ID matching is supported.", + "description": "Optional. The filter used to filter profiles. The following fields can be used in the filter: - profile_id - display_name - user_email - last_activity_time - last_policy_sync_time - last_status_report_time - first_enrollment_time - os_platform_type - os_version - browser_version - browser_channel - policy_count - extension_count - identity_provider - affiliation_state - os_platform_version - ouId Any of the above fields can be used to specify a filter, and filtering by multiple fields is supported with AND operator. String type fields and enum type fields support '=' and '!=' operators. The integer type and the timestamp type fields support '=', '!=', '\u003c', '\u003e', '\u003c=' and '\u003e=' operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard '*' can be used with a string type field filter. In addition, string literal filtering is also supported, for example, 'ABC' as a filter maps to a filter that checks if any of the filterable string type fields contains 'ABC'. Organization unit number can be used as a filtering criteria here by specifying 'ouId = ${your_org_unit_id}', please note that only single OU ID matching is supported.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. The fields used to specify the ordering of the results. The supported fields are: - profile_id - display_name - user_email - last_activity_time - last_policy_sync_time - last_status_report_time - first_enrollment_time - os_platform_type - os_version - browser_version - browser_channel - policy_count - extension_count - identity_provider - affiliation_state By default, sorting is in ascending order, to specify descending order for a field, a suffix \" desc\" should be added to the field name. The default ordering is the descending order of last_status_report_time.", + "description": "Optional. The fields used to specify the ordering of the results. The supported fields are: - profile_id - display_name - user_email - last_activity_time - last_policy_sync_time - last_status_report_time - first_enrollment_time - os_platform_type - os_version - browser_version - browser_channel - policy_count - extension_count - identity_provider - affiliation_state - os_platform_version By default, sorting is in ascending order, to specify descending order for a field, a suffix \" desc\" should be added to the field name. The default ordering is the descending order of last_status_report_time.", "location": "query", "type": "string" }, @@ -1280,7 +1280,7 @@ } } }, - "revision": "20250309", + "revision": "20250313", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -5015,11 +5015,6 @@ "description": "A certificate provisioning process.", "id": "GoogleChromeManagementVersionsV1CertificateProvisioningProcess", "properties": { - "caConnectionAdapterConfigReference": { - "description": "Output only. A JSON string that contains the administrator-provided configuration for the certification authority service. This field can be missing if no configuration was given.", - "readOnly": true, - "type": "string" - }, "chromeOsDevice": { "$ref": "GoogleChromeManagementVersionsV1ChromeOsDevice", "description": "Output only. The client certificate is being provisioned for a ChromeOS device. This contains information about the device.", @@ -5027,11 +5022,11 @@ }, "chromeOsUserSession": { "$ref": "GoogleChromeManagementVersionsV1ChromeOsUserSession", - "description": "Output only. The client certificate is being provisioned for a ChromeOS user session. This contains information about the user session.", + "description": "Output only. The client certificate is being provisioned for a ChromeOS user. This contains information about the current user session.", "readOnly": true }, "failureMessage": { - "description": "Output only. A message describing why this `CertificateProvisioningProcess` failed. Presence of this field indicates that the `CertificateProvisioningProcess` has failed.", + "description": "Output only. A message describing why this `CertificateProvisioningProcess` has failed. Presence of this field indicates that the `CertificateProvisioningProcess` has failed.", "readOnly": true, "type": "string" }, @@ -5054,11 +5049,6 @@ "description": "Identifier. Resource name of the `CertificateProvisioningProcess`. The name pattern is given as `customers/{customer}/certificateProvisioningProcesses/{certificate_provisioning_process}` with `{customer}` being the obfuscated customer id and `{certificate_provisioning_process}` being the certificate provisioning process id.", "type": "string" }, - "profileAdapterConfigReference": { - "description": "Output only. A JSON string that contains the administrator-provided configuration for the certificate provisioning profile. This field can be missing if no configuration was given.", - "readOnly": true, - "type": "string" - }, "provisioningProfileId": { "description": "Output only. The ID of the certificate provisioning profile.", "readOnly": true, @@ -5071,7 +5061,7 @@ "type": "string" }, "signature": { - "description": "Output only. The signature of `signature_algorithm`, generated using the client's private key using `signature_algorithm`. This field is only present after the`SignData` operation has finished.", + "description": "Output only. The signature of `signature_algorithm`, generated using the client's private key using `signature_algorithm`. This field is only present after the `SignData` operation has finished.", "format": "byte", "readOnly": true, "type": "string" @@ -5228,7 +5218,7 @@ "type": "string" }, "osPlatformVersion": { - "description": "Output only. Major OS version of the device on which the profile exists. (i.e. Windows 10)", + "description": "Output only. Major OS platform version of the device on which the profile exists, from profile reporting.", "readOnly": true, "type": "string" }, @@ -5294,7 +5284,7 @@ "properties": { "chromeOsDevice": { "$ref": "GoogleChromeManagementVersionsV1ChromeOsDevice", - "description": "Output only. This field contains information about the ChromeOS device that the user session is running on. It is only set if the user session is affiliated, i.e. if the user is managed by the same organization that managed the ChromeOS device.", + "description": "Output only. This field contains information about the ChromeOS device that the user session is running on. It is only set if the user is affiliated, i.e., if the user is managed by the same organization that manages the ChromeOS device.", "readOnly": true }, "userDirectoryApiId": { diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index df5ff57606..b88837e7ad 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -4075,20 +4075,16 @@ func (s GoogleChromeManagementVersionsV1AttestationCredential) MarshalJSON() ([] // GoogleChromeManagementVersionsV1CertificateProvisioningProcess: A // certificate provisioning process. type GoogleChromeManagementVersionsV1CertificateProvisioningProcess struct { - // CaConnectionAdapterConfigReference: Output only. A JSON string that contains - // the administrator-provided configuration for the certification authority - // service. This field can be missing if no configuration was given. - CaConnectionAdapterConfigReference string `json:"caConnectionAdapterConfigReference,omitempty"` // ChromeOsDevice: Output only. The client certificate is being provisioned for // a ChromeOS device. This contains information about the device. ChromeOsDevice *GoogleChromeManagementVersionsV1ChromeOsDevice `json:"chromeOsDevice,omitempty"` // ChromeOsUserSession: Output only. The client certificate is being - // provisioned for a ChromeOS user session. This contains information about the + // provisioned for a ChromeOS user. This contains information about the current // user session. ChromeOsUserSession *GoogleChromeManagementVersionsV1ChromeOsUserSession `json:"chromeOsUserSession,omitempty"` // FailureMessage: Output only. A message describing why this - // `CertificateProvisioningProcess` failed. Presence of this field indicates - // that the `CertificateProvisioningProcess` has failed. + // `CertificateProvisioningProcess` has failed. Presence of this field + // indicates that the `CertificateProvisioningProcess` has failed. FailureMessage string `json:"failureMessage,omitempty"` // GenericCaConnection: Output only. The CA connection is a generic CA // connection. @@ -4106,10 +4102,6 @@ type GoogleChromeManagementVersionsV1CertificateProvisioningProcess struct { // `{certificate_provisioning_process}` being the certificate provisioning // process id. Name string `json:"name,omitempty"` - // ProfileAdapterConfigReference: Output only. A JSON string that contains the - // administrator-provided configuration for the certificate provisioning - // profile. This field can be missing if no configuration was given. - ProfileAdapterConfigReference string `json:"profileAdapterConfigReference,omitempty"` // ProvisioningProfileId: Output only. The ID of the certificate provisioning // profile. ProvisioningProfileId string `json:"provisioningProfileId,omitempty"` @@ -4118,7 +4110,7 @@ type GoogleChromeManagementVersionsV1CertificateProvisioningProcess struct { SignData string `json:"signData,omitempty"` // Signature: Output only. The signature of `signature_algorithm`, generated // using the client's private key using `signature_algorithm`. This field is - // only present after the`SignData` operation has finished. + // only present after the `SignData` operation has finished. Signature string `json:"signature,omitempty"` // SignatureAlgorithm: Output only. The signature algorithm that the adapter // expects the client and backend components to use when processing @@ -4138,18 +4130,16 @@ type GoogleChromeManagementVersionsV1CertificateProvisioningProcess struct { // should be provisioned. Represented as a DER-encoded X.509 // SubjectPublicKeyInfo. SubjectPublicKeyInfo string `json:"subjectPublicKeyInfo,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "CaConnectionAdapterConfigReference") to unconditionally include in API - // requests. By default, fields with empty or default values are omitted from - // API requests. See + // ForceSendFields is a list of field names (e.g. "ChromeOsDevice") 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. - // "CaConnectionAdapterConfigReference") 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 is a list of field names (e.g. "ChromeOsDevice") 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:"-"` } @@ -4232,8 +4222,8 @@ type GoogleChromeManagementVersionsV1ChromeBrowserProfile struct { // OsPlatformType: Output only. OS platform of the device on which the profile // exists. OsPlatformType string `json:"osPlatformType,omitempty"` - // OsPlatformVersion: Output only. Major OS version of the device on which the - // profile exists. (i.e. Windows 10) + // OsPlatformVersion: Output only. Major OS platform version of the device on + // which the profile exists, from profile reporting. OsPlatformVersion string `json:"osPlatformVersion,omitempty"` // OsVersion: Output only. OS version of the device on which the profile // exists. @@ -4308,8 +4298,8 @@ func (s GoogleChromeManagementVersionsV1ChromeOsDevice) MarshalJSON() ([]byte, e type GoogleChromeManagementVersionsV1ChromeOsUserSession struct { // ChromeOsDevice: Output only. This field contains information about the // ChromeOS device that the user session is running on. It is only set if the - // user session is affiliated, i.e. if the user is managed by the same - // organization that managed the ChromeOS device. + // user is affiliated, i.e., if the user is managed by the same organization + // that manages the ChromeOS device. ChromeOsDevice *GoogleChromeManagementVersionsV1ChromeOsDevice `json:"chromeOsDevice,omitempty"` // UserDirectoryApiId: Output only. The unique Directory API ID of the user. UserDirectoryApiId string `json:"userDirectoryApiId,omitempty"` @@ -5849,18 +5839,19 @@ func (r *CustomersProfilesService) List(parent string) *CustomersProfilesListCal // display_name - user_email - last_activity_time - last_policy_sync_time - // last_status_report_time - first_enrollment_time - os_platform_type - // os_version - browser_version - browser_channel - policy_count - -// extension_count - identity_provider - affiliation_state - ouId Any of the -// above fields can be used to specify a filter, and filtering by multiple -// fields is supported with AND operator. String type fields and enum type -// fields support '=' and '!=' operators. The integer type and the timestamp -// type fields support '=', '!=', '<', '>', '<=' and '>=' operators. Timestamps -// expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). -// Wildcard '*' can be used with a string type field filter. In addition, -// string literal filtering is also supported, for example, 'ABC' as a filter -// maps to a filter that checks if any of the filterable string type fields -// contains 'ABC'. Organization unit number can be used as a filtering criteria -// here by specifying 'ouId = ${your_org_unit_id}', please note that only -// single OU ID matching is supported. +// extension_count - identity_provider - affiliation_state - +// os_platform_version - ouId Any of the above fields can be used to specify a +// filter, and filtering by multiple fields is supported with AND operator. +// String type fields and enum type fields support '=' and '!=' operators. The +// integer type and the timestamp type fields support '=', '!=', '<', '>', '<=' +// and '>=' operators. Timestamps expect an RFC-3339 formatted string (e.g. +// 2012-04-21T11:30:00-04:00). Wildcard '*' can be used with a string type +// field filter. In addition, string literal filtering is also supported, for +// example, 'ABC' as a filter maps to a filter that checks if any of the +// filterable string type fields contains 'ABC'. Organization unit number can +// be used as a filtering criteria here by specifying 'ouId = +// ${your_org_unit_id}', please note that only single OU ID matching is +// supported. func (c *CustomersProfilesListCall) Filter(filter string) *CustomersProfilesListCall { c.urlParams_.Set("filter", filter) return c @@ -5871,10 +5862,11 @@ func (c *CustomersProfilesListCall) Filter(filter string) *CustomersProfilesList // display_name - user_email - last_activity_time - last_policy_sync_time - // last_status_report_time - first_enrollment_time - os_platform_type - // os_version - browser_version - browser_channel - policy_count - -// extension_count - identity_provider - affiliation_state By default, sorting -// is in ascending order, to specify descending order for a field, a suffix " -// desc" should be added to the field name. The default ordering is the -// descending order of last_status_report_time. +// extension_count - identity_provider - affiliation_state - +// os_platform_version By default, sorting is in ascending order, to specify +// descending order for a field, a suffix " desc" should be added to the field +// name. The default ordering is the descending order of +// last_status_report_time. func (c *CustomersProfilesListCall) OrderBy(orderBy string) *CustomersProfilesListCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index bb4058a172..09e5af141d 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -1095,7 +1095,7 @@ } } }, - "revision": "20250215", + "revision": "20250307", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -2918,6 +2918,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -3010,6 +3017,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 645753b1b4..30b8ae178f 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -3131,6 +3131,10 @@ type GoogleIdentityAccesscontextmanagerV1EgressTo struct { // this list. If `*` is specified for `resources`, then this EgressTo rule will // authorize access to all resources outside the perimeter. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding EgressFrom. are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -3290,6 +3294,10 @@ type GoogleIdentityAccesscontextmanagerV1IngressTo struct { // `*` is specified, then access to all resources inside the perimeter are // allowed. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding IngressFrom are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "Operations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1beta1/cloudasset-api.json b/cloudasset/v1beta1/cloudasset-api.json index 3672ed04f3..aa77121d8b 100644 --- a/cloudasset/v1beta1/cloudasset-api.json +++ b/cloudasset/v1beta1/cloudasset-api.json @@ -411,7 +411,7 @@ } } }, - "revision": "20250215", + "revision": "20250307", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1228,6 +1228,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -1320,6 +1327,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index 7d4aea2191..bf3fe20d6f 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -1576,6 +1576,10 @@ type GoogleIdentityAccesscontextmanagerV1EgressTo struct { // this list. If `*` is specified for `resources`, then this EgressTo rule will // authorize access to all resources outside the perimeter. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding EgressFrom. are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1735,6 +1739,10 @@ type GoogleIdentityAccesscontextmanagerV1IngressTo struct { // `*` is specified, then access to all resources inside the perimeter are // allowed. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding IngressFrom are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "Operations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1p1beta1/cloudasset-api.json b/cloudasset/v1p1beta1/cloudasset-api.json index dec6ebd28f..9e7bc0a29a 100644 --- a/cloudasset/v1p1beta1/cloudasset-api.json +++ b/cloudasset/v1p1beta1/cloudasset-api.json @@ -207,7 +207,7 @@ } } }, - "revision": "20250215", + "revision": "20250307", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -930,6 +930,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -1022,6 +1029,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index 0789af72bd..1d79e39ab4 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -1387,6 +1387,10 @@ type GoogleIdentityAccesscontextmanagerV1EgressTo struct { // this list. If `*` is specified for `resources`, then this EgressTo rule will // authorize access to all resources outside the perimeter. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding EgressFrom. are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1546,6 +1550,10 @@ type GoogleIdentityAccesscontextmanagerV1IngressTo struct { // `*` is specified, then access to all resources inside the perimeter are // allowed. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding IngressFrom are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "Operations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1p5beta1/cloudasset-api.json b/cloudasset/v1p5beta1/cloudasset-api.json index abdf8bf68c..add68aaaaf 100644 --- a/cloudasset/v1p5beta1/cloudasset-api.json +++ b/cloudasset/v1p5beta1/cloudasset-api.json @@ -177,7 +177,7 @@ } } }, - "revision": "20250215", + "revision": "20250307", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -935,6 +935,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -1027,6 +1034,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index 1e8bfacb39..5d1e8d26f6 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -1421,6 +1421,10 @@ type GoogleIdentityAccesscontextmanagerV1EgressTo struct { // this list. If `*` is specified for `resources`, then this EgressTo rule will // authorize access to all resources outside the perimeter. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding EgressFrom. are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1580,6 +1584,10 @@ type GoogleIdentityAccesscontextmanagerV1IngressTo struct { // `*` is specified, then access to all resources inside the perimeter are // allowed. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding IngressFrom are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "Operations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1p7beta1/cloudasset-api.json b/cloudasset/v1p7beta1/cloudasset-api.json index 71f6b5b773..6b28194b51 100644 --- a/cloudasset/v1p7beta1/cloudasset-api.json +++ b/cloudasset/v1p7beta1/cloudasset-api.json @@ -167,7 +167,7 @@ } } }, - "revision": "20250215", + "revision": "20250307", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1004,6 +1004,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -1096,6 +1103,13 @@ "type": "string" }, "type": "array" + }, + "roles": { + "description": "IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/cloudasset/v1p7beta1/cloudasset-gen.go b/cloudasset/v1p7beta1/cloudasset-gen.go index 41597d8ce0..788313a4d5 100644 --- a/cloudasset/v1p7beta1/cloudasset-gen.go +++ b/cloudasset/v1p7beta1/cloudasset-gen.go @@ -1597,6 +1597,10 @@ type GoogleIdentityAccesscontextmanagerV1EgressTo struct { // this list. If `*` is specified for `resources`, then this EgressTo rule will // authorize access to all resources outside the perimeter. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding EgressFrom. are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "ExternalResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1756,6 +1760,10 @@ type GoogleIdentityAccesscontextmanagerV1IngressTo struct { // `*` is specified, then access to all resources inside the perimeter are // allowed. Resources []string `json:"resources,omitempty"` + // Roles: IAM roles that represent the set of operations that the sources + // specified in the corresponding IngressFrom are allowed to perform in this + // ServicePerimeter. + Roles []string `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "Operations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 7aee25ba1d..e577eaff9a 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -38642,7 +38642,7 @@ } } }, - "revision": "20250224", + "revision": "20250302", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -43748,6 +43748,7 @@ "GRAPHICS_OPTIMIZED", "MEMORY_OPTIMIZED", "MEMORY_OPTIMIZED_M3", + "MEMORY_OPTIMIZED_M4", "MEMORY_OPTIMIZED_X4_16TB", "MEMORY_OPTIMIZED_X4_24TB", "MEMORY_OPTIMIZED_X4_32TB", @@ -43779,6 +43780,7 @@ "", "", "", + "", "Note for internal users: When adding a new enum Type for v1, make sure to also add it in the comment for the `optional Type type` definition. This ensures that the public documentation displays the new enum Type." ], "type": "string" @@ -67658,11 +67660,13 @@ "description": "The public delegated prefix mode for IPv6 only.", "enum": [ "DELEGATION", - "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" + "EXTERNAL_IPV6_FORWARDING_RULE_CREATION", + "EXTERNAL_IPV6_SUBNETWORK_CREATION" ], "enumDescriptions": [ "The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength.", - "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes." + "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes.", + "The public delegated prefix is used for creating dual-mode subnetworks only. Such prefixes cannot set publicDelegatedSubPrefixes." ], "type": "string" }, @@ -68063,11 +68067,13 @@ "description": "The PublicDelegatedSubPrefix mode for IPv6 only.", "enum": [ "DELEGATION", - "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" + "EXTERNAL_IPV6_FORWARDING_RULE_CREATION", + "EXTERNAL_IPV6_SUBNETWORK_CREATION" ], "enumDescriptions": [ "The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength.", - "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes." + "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes.", + "The public delegated prefix is used for creating dual-mode subnetworks only. Such prefixes cannot set publicDelegatedSubPrefixes." ], "type": "string" }, @@ -71932,6 +71938,10 @@ "description": "[Output Only] The precise location of your instance within the zone's data center, including the block, sub-block, and host. The field is formatted as follows: blockId/subBlockId/hostId.", "type": "string" }, + "physicalHostTopology": { + "$ref": "ResourceStatusPhysicalHostTopology", + "description": "[Output Only] A series of fields containing the global name of the Compute Engine cluster, as well as the ID of the block, sub-block, and host on which the running instance is located." + }, "scheduling": { "$ref": "ResourceStatusScheduling" }, @@ -71941,6 +71951,29 @@ }, "type": "object" }, + "ResourceStatusPhysicalHostTopology": { + "description": "Represents the physical host topology of the host on which the VM is running.", + "id": "ResourceStatusPhysicalHostTopology", + "properties": { + "block": { + "description": "[Output Only] The ID of the block in which the running instance is located. Instances within the same block experience low network latency.", + "type": "string" + }, + "cluster": { + "description": "[Output Only] The global name of the Compute Engine cluster where the running instance is located.", + "type": "string" + }, + "host": { + "description": "[Output Only] The ID of the host on which the running instance is located. Instances on the same host experience the lowest possible network latency.", + "type": "string" + }, + "subblock": { + "description": "[Output Only] The ID of the sub-block in which the running instance is located. Instances in the same sub-block experience lower network latency than instances in the same block.", + "type": "string" + } + }, + "type": "object" + }, "ResourceStatusScheduling": { "id": "ResourceStatusScheduling", "properties": { @@ -74602,10 +74635,12 @@ "provisioningModel": { "description": "Specifies the provisioning model of the instance.", "enum": [ + "RESERVATION_BOUND", "SPOT", "STANDARD" ], "enumDescriptions": [ + "Bound to the lifecycle of the reservation in which it is provisioned.", "Heavily discounted, no guaranteed runtime.", "Standard provisioning with user controlled runtime, no discounts." ], @@ -80274,6 +80309,10 @@ "description": "The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.", "type": "string" }, + "ipCollection": { + "description": "Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to specify a sub-PDP when creating a dual stack subnetwork with external access using BYOIP: - Full resource URL, as in https://www.googleapis.com/compute/v1/projects/projectId/regions/region /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name ", + "type": "string" + }, "ipv6AccessType": { "description": "The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.", "enum": [ @@ -80290,6 +80329,18 @@ "description": "[Output Only] This field is for internal use.", "type": "string" }, + "ipv6GceEndpoint": { + "description": "[Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. ", + "enum": [ + "VM_AND_FR", + "VM_ONLY" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, "kind": { "default": "compute#subnetwork", "description": "[Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources.", diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index 125e2b0f07..a6498bc6c5 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -7516,6 +7516,7 @@ type Commitment struct { // "GRAPHICS_OPTIMIZED" // "MEMORY_OPTIMIZED" // "MEMORY_OPTIMIZED_M3" + // "MEMORY_OPTIMIZED_M4" // "MEMORY_OPTIMIZED_X4_16TB" // "MEMORY_OPTIMIZED_X4_24TB" // "MEMORY_OPTIMIZED_X4_32TB" @@ -34220,6 +34221,9 @@ type PublicDelegatedPrefix struct { // "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" - The public delegated prefix is // used for creating forwarding rules only. Such prefixes cannot set // publicDelegatedSubPrefixes. + // "EXTERNAL_IPV6_SUBNETWORK_CREATION" - The public delegated prefix is used + // for creating dual-mode subnetworks only. Such prefixes cannot set + // publicDelegatedSubPrefixes. Mode string `json:"mode,omitempty"` // Name: Name of the resource. Provided by the client when the resource is // created. The name must be 1-63 characters long, and comply with RFC1035. @@ -34621,6 +34625,9 @@ type PublicDelegatedPrefixPublicDelegatedSubPrefix struct { // "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" - The public delegated prefix is // used for creating forwarding rules only. Such prefixes cannot set // publicDelegatedSubPrefixes. + // "EXTERNAL_IPV6_SUBNETWORK_CREATION" - The public delegated prefix is used + // for creating dual-mode subnetworks only. Such prefixes cannot set + // publicDelegatedSubPrefixes. Mode string `json:"mode,omitempty"` // Name: The name of the sub public delegated prefix. Name string `json:"name,omitempty"` @@ -38807,9 +38814,13 @@ type ResourceStatus struct { // PhysicalHost: [Output Only] The precise location of your instance within the // zone's data center, including the block, sub-block, and host. The field is // formatted as follows: blockId/subBlockId/hostId. - PhysicalHost string `json:"physicalHost,omitempty"` - Scheduling *ResourceStatusScheduling `json:"scheduling,omitempty"` - UpcomingMaintenance *UpcomingMaintenance `json:"upcomingMaintenance,omitempty"` + PhysicalHost string `json:"physicalHost,omitempty"` + // PhysicalHostTopology: [Output Only] A series of fields containing the global + // name of the Compute Engine cluster, as well as the ID of the block, + // sub-block, and host on which the running instance is located. + PhysicalHostTopology *ResourceStatusPhysicalHostTopology `json:"physicalHostTopology,omitempty"` + Scheduling *ResourceStatusScheduling `json:"scheduling,omitempty"` + UpcomingMaintenance *UpcomingMaintenance `json:"upcomingMaintenance,omitempty"` // ForceSendFields is a list of field names (e.g. "PhysicalHost") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -38828,6 +38839,41 @@ func (s ResourceStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ResourceStatusPhysicalHostTopology: Represents the physical host topology of +// the host on which the VM is running. +type ResourceStatusPhysicalHostTopology struct { + // Block: [Output Only] The ID of the block in which the running instance is + // located. Instances within the same block experience low network latency. + Block string `json:"block,omitempty"` + // Cluster: [Output Only] The global name of the Compute Engine cluster where + // the running instance is located. + Cluster string `json:"cluster,omitempty"` + // Host: [Output Only] The ID of the host on which the running instance is + // located. Instances on the same host experience the lowest possible network + // latency. + Host string `json:"host,omitempty"` + // Subblock: [Output Only] The ID of the sub-block in which the running + // instance is located. Instances in the same sub-block experience lower + // network latency than instances in the same block. + Subblock string `json:"subblock,omitempty"` + // ForceSendFields is a list of field names (e.g. "Block") 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. "Block") 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 ResourceStatusPhysicalHostTopology) MarshalJSON() ([]byte, error) { + type NoMethod ResourceStatusPhysicalHostTopology + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ResourceStatusScheduling struct { // AvailabilityDomain: Specifies the availability domain to place the instance // in. The value must be a number between 1 and the number of availability @@ -41496,6 +41542,8 @@ type Scheduling struct { // ProvisioningModel: Specifies the provisioning model of the instance. // // Possible values: + // "RESERVATION_BOUND" - Bound to the lifecycle of the reservation in which + // it is provisioned. // "SPOT" - Heavily discounted, no guaranteed runtime. // "STANDARD" - Standard provisioning with user controlled runtime, no // discounts. @@ -47651,6 +47699,16 @@ type Subnetwork struct { // ranges list. The range can be expanded after creation using // expandIpCidrRange. IpCidrRange string `json:"ipCidrRange,omitempty"` + // IpCollection: Reference to the source of IP, like a PublicDelegatedPrefix + // (PDP) for BYOIP. The PDP must be a sub-PDP in + // EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to + // specify a sub-PDP when creating a dual stack subnetwork with external access + // using BYOIP: - Full resource URL, as in + // https://www.googleapis.com/compute/v1/projects/projectId/regions/region + // /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - + // projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - + // regions/region/publicDelegatedPrefixes/sub-pdp-name + IpCollection string `json:"ipCollection,omitempty"` // Ipv6AccessType: The access type of IPv6 address this subnet holds. It's // immutable and can only be specified during creation or the first time the // subnet is updated into IPV4_IPV6 dual stack. @@ -47663,6 +47721,19 @@ type Subnetwork struct { Ipv6AccessType string `json:"ipv6AccessType,omitempty"` // Ipv6CidrRange: [Output Only] This field is for internal use. Ipv6CidrRange string `json:"ipv6CidrRange,omitempty"` + // Ipv6GceEndpoint: [Output Only] Possible endpoints of this subnetwork. It can + // be one of the following: - VM_ONLY: The subnetwork can be used for creating + // instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets + // external IPv6 ranges from a public delegated prefix and cannot be used to + // create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM + // instances and Forwarding Rules. It can also be used to reserve IPv6 + // addresses with both VM and FR endpoint types. Such a subnetwork gets its + // IPv6 range from Google IP Pool directly. + // + // Possible values: + // "VM_AND_FR" + // "VM_ONLY" + Ipv6GceEndpoint string `json:"ipv6GceEndpoint,omitempty"` // Kind: [Output Only] Type of the resource. Always compute#subnetwork for // Subnetwork resources. Kind string `json:"kind,omitempty"` diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index 1e7b13f1b1..a9555bbaa9 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -109,6 +109,34 @@ "resources": { "locations": { "methods": { + "bulkDeleteFeedbackLabels": { + "description": "Delete feedback labels in bulk using a filter.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:bulkDeleteFeedbackLabels", + "httpMethod": "POST", + "id": "contactcenterinsights.projects.locations.bulkDeleteFeedbackLabels", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource for new feedback labels.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}:bulkDeleteFeedbackLabels", + "request": { + "$ref": "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "bulkDownloadFeedbackLabels": { "description": "Download feedback labels in bulk from an external source. Currently supports exporting Quality AI example conversations with transcripts and question bodies.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:bulkDownloadFeedbackLabels", @@ -2609,7 +2637,7 @@ } } }, - "revision": "20250224", + "revision": "20250311", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { @@ -3106,6 +3134,46 @@ "properties": {}, "type": "object" }, + "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsMetadata": { + "description": "Metadata for the BulkDeleteFeedbackLabels endpoint.", + "id": "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsMetadata", + "properties": { + "partialErrors": { + "description": "Partial errors during deletion operation that might cause the operation output to be incomplete.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "type": "array" + }, + "request": { + "$ref": "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest", + "description": "Output only. The original request for delete.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest": { + "description": "Request for the BulkDeleteFeedbackLabels endpoint.", + "id": "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest", + "properties": { + "filter": { + "description": "Optional. A filter to reduce results to a specific subset. Supports disjunctions (OR) and conjunctions (AND). Supported fields: * `issue_model_id` * `qa_question_id` * `qa_scorecard_id` * `min_create_time` * `max_create_time` * `min_update_time` * `max_update_time` * `feedback_label_type`: QUALITY_AI, TOPIC_MODELING", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource for new feedback labels.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsResponse": { + "description": "Response for the BulkDeleteFeedbackLabels endpoint.", + "id": "GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsMetadata": { "description": "Metadata for the BulkDownloadFeedbackLabel endpoint.", "id": "GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsMetadata", @@ -4165,7 +4233,8 @@ "AGENT_TEAM", "QA_QUESTION_ID", "QA_QUESTION_ANSWER_VALUE", - "CONVERSATION_PROFILE_ID" + "CONVERSATION_PROFILE_ID", + "MEDIUM" ], "enumDescriptions": [ "The key of the dimension is unspecified.", @@ -4175,7 +4244,8 @@ "The dimension is keyed by agent teams.", "The dimension is keyed by QaQuestionIds. Note that: We only group by the QuestionId and not the revision-id of the scorecard this question is a part of. This allows for showing stats for the same question across different scorecard revisions.", "The dimension is keyed by QaQuestionIds-Answer value pairs. Note that: We only group by the QuestionId and not the revision-id of the scorecard this question is a part of. This allows for showing distribution of answers per question across different scorecard revisions.", - "The dimension is keyed by the conversation profile ID." + "The dimension is keyed by the conversation profile ID.", + "The dimension is keyed by the conversation medium." ], "type": "string" }, @@ -7148,6 +7218,46 @@ "properties": {}, "type": "object" }, + "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsMetadata": { + "description": "Metadata for the BulkDeleteFeedbackLabels endpoint.", + "id": "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsMetadata", + "properties": { + "partialErrors": { + "description": "Partial errors during deletion operation that might cause the operation output to be incomplete.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "type": "array" + }, + "request": { + "$ref": "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest", + "description": "Output only. The original request for delete.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest": { + "description": "Request for the BulkDeleteFeedbackLabels endpoint.", + "id": "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest", + "properties": { + "filter": { + "description": "Optional. A filter to reduce results to a specific subset. Supports disjunctions (OR) and conjunctions (AND). Supported fields: * `issue_model_id` * `qa_question_id` * `qa_scorecard_id` * `min_create_time` * `max_create_time` * `min_update_time` * `max_update_time` * `feedback_label_type`: QUALITY_AI, TOPIC_MODELING", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource for new feedback labels.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsResponse": { + "description": "Response for the BulkDeleteFeedbackLabels endpoint.", + "id": "GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudContactcenterinsightsV1alpha1CallAnnotation": { "description": "A piece of metadata that applies to a window of a call.", "id": "GoogleCloudContactcenterinsightsV1alpha1CallAnnotation", @@ -7897,7 +8007,8 @@ "AGENT_TEAM", "QA_QUESTION_ID", "QA_QUESTION_ANSWER_VALUE", - "CONVERSATION_PROFILE_ID" + "CONVERSATION_PROFILE_ID", + "MEDIUM" ], "enumDescriptions": [ "The key of the dimension is unspecified.", @@ -7907,7 +8018,8 @@ "The dimension is keyed by agent teams.", "The dimension is keyed by QaQuestionIds. Note that: We only group by the QuestionId and not the revision-id of the scorecard this question is a part of. This allows for showing stats for the same question across different scorecard revisions.", "The dimension is keyed by QaQuestionIds-Answer value pairs. Note that: We only group by the QuestionId and not the revision-id of the scorecard this question is a part of. This allows for showing distribution of answers per question across different scorecard revisions.", - "The dimension is keyed by the conversation profile ID." + "The dimension is keyed by the conversation profile ID.", + "The dimension is keyed by the conversation medium." ], "type": "string" }, diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index 27d71da858..1a8b0b9483 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -982,6 +982,66 @@ func (s GoogleCloudContactcenterinsightsV1BulkDeleteConversationsRequest) Marsha type GoogleCloudContactcenterinsightsV1BulkDeleteConversationsResponse struct { } +// GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsMetadata: Metadata +// for the BulkDeleteFeedbackLabels endpoint. +type GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsMetadata struct { + // PartialErrors: Partial errors during deletion operation that might cause the + // operation output to be incomplete. + PartialErrors []*GoogleRpcStatus `json:"partialErrors,omitempty"` + // Request: Output only. The original request for delete. + Request *GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest `json:"request,omitempty"` + // ForceSendFields is a list of field names (e.g. "PartialErrors") 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. "PartialErrors") 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 GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest: Request +// for the BulkDeleteFeedbackLabels endpoint. +type GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest struct { + // Filter: Optional. A filter to reduce results to a specific subset. Supports + // disjunctions (OR) and conjunctions (AND). Supported fields: * + // `issue_model_id` * `qa_question_id` * `qa_scorecard_id` * `min_create_time` + // * `max_create_time` * `min_update_time` * `max_update_time` * + // `feedback_label_type`: QUALITY_AI, TOPIC_MODELING + Filter string `json:"filter,omitempty"` + // Parent: Required. The parent resource for new feedback labels. + Parent string `json:"parent,omitempty"` + // ForceSendFields is a list of field names (e.g. "Filter") 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. "Filter") 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 GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsResponse: Response +// for the BulkDeleteFeedbackLabels endpoint. +type GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsResponse struct { +} + // GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsMetadata: // Metadata for the BulkDownloadFeedbackLabel endpoint. type GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsMetadata struct { @@ -2281,6 +2341,7 @@ type GoogleCloudContactcenterinsightsV1Dimension struct { // scorecard revisions. // "CONVERSATION_PROFILE_ID" - The dimension is keyed by the conversation // profile ID. + // "MEDIUM" - The dimension is keyed by the conversation medium. DimensionKey string `json:"dimensionKey,omitempty"` // IssueDimensionMetadata: Output only. Metadata about the issue dimension. IssueDimensionMetadata *GoogleCloudContactcenterinsightsV1DimensionIssueDimensionMetadata `json:"issueDimensionMetadata,omitempty"` @@ -6213,6 +6274,66 @@ func (s GoogleCloudContactcenterinsightsV1alpha1BulkDeleteConversationsRequest) type GoogleCloudContactcenterinsightsV1alpha1BulkDeleteConversationsResponse struct { } +// GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsMetadata: +// Metadata for the BulkDeleteFeedbackLabels endpoint. +type GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsMetadata struct { + // PartialErrors: Partial errors during deletion operation that might cause the + // operation output to be incomplete. + PartialErrors []*GoogleRpcStatus `json:"partialErrors,omitempty"` + // Request: Output only. The original request for delete. + Request *GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest `json:"request,omitempty"` + // ForceSendFields is a list of field names (e.g. "PartialErrors") 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. "PartialErrors") 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 GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest: +// Request for the BulkDeleteFeedbackLabels endpoint. +type GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest struct { + // Filter: Optional. A filter to reduce results to a specific subset. Supports + // disjunctions (OR) and conjunctions (AND). Supported fields: * + // `issue_model_id` * `qa_question_id` * `qa_scorecard_id` * `min_create_time` + // * `max_create_time` * `min_update_time` * `max_update_time` * + // `feedback_label_type`: QUALITY_AI, TOPIC_MODELING + Filter string `json:"filter,omitempty"` + // Parent: Required. The parent resource for new feedback labels. + Parent string `json:"parent,omitempty"` + // ForceSendFields is a list of field names (e.g. "Filter") 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. "Filter") 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 GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsResponse: +// Response for the BulkDeleteFeedbackLabels endpoint. +type GoogleCloudContactcenterinsightsV1alpha1BulkDeleteFeedbackLabelsResponse struct { +} + // GoogleCloudContactcenterinsightsV1alpha1CallAnnotation: A piece of metadata // that applies to a window of a call. type GoogleCloudContactcenterinsightsV1alpha1CallAnnotation struct { @@ -7150,6 +7271,7 @@ type GoogleCloudContactcenterinsightsV1alpha1Dimension struct { // scorecard revisions. // "CONVERSATION_PROFILE_ID" - The dimension is keyed by the conversation // profile ID. + // "MEDIUM" - The dimension is keyed by the conversation medium. DimensionKey string `json:"dimensionKey,omitempty"` // IssueDimensionMetadata: Output only. Metadata about the issue dimension. IssueDimensionMetadata *GoogleCloudContactcenterinsightsV1alpha1DimensionIssueDimensionMetadata `json:"issueDimensionMetadata,omitempty"` @@ -9695,6 +9817,110 @@ func (s GoogleTypeInterval) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ProjectsLocationsBulkDeleteFeedbackLabelsCall struct { + s *Service + parent string + googlecloudcontactcenterinsightsv1bulkdeletefeedbacklabelsrequest *GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// BulkDeleteFeedbackLabels: Delete feedback labels in bulk using a filter. +// +// - parent: The parent resource for new feedback labels. +func (r *ProjectsLocationsService) BulkDeleteFeedbackLabels(parent string, googlecloudcontactcenterinsightsv1bulkdeletefeedbacklabelsrequest *GoogleCloudContactcenterinsightsV1BulkDeleteFeedbackLabelsRequest) *ProjectsLocationsBulkDeleteFeedbackLabelsCall { + c := &ProjectsLocationsBulkDeleteFeedbackLabelsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudcontactcenterinsightsv1bulkdeletefeedbacklabelsrequest = googlecloudcontactcenterinsightsv1bulkdeletefeedbacklabelsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBulkDeleteFeedbackLabelsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBulkDeleteFeedbackLabelsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBulkDeleteFeedbackLabelsCall) Context(ctx context.Context) *ProjectsLocationsBulkDeleteFeedbackLabelsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsBulkDeleteFeedbackLabelsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBulkDeleteFeedbackLabelsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudcontactcenterinsightsv1bulkdeletefeedbacklabelsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:bulkDeleteFeedbackLabels") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "contactcenterinsights.projects.locations.bulkDeleteFeedbackLabels", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "contactcenterinsights.projects.locations.bulkDeleteFeedbackLabels" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsBulkDeleteFeedbackLabelsCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "contactcenterinsights.projects.locations.bulkDeleteFeedbackLabels", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsBulkDownloadFeedbackLabelsCall struct { s *Service parent string diff --git a/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index 6f40147ba7..00ea7cf825 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -200,6 +200,26 @@ "description": "Regional Endpoint", "endpointUrl": "https://containeranalysis.us-west4.rep.googleapis.com/", "location": "us-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.europe-west10.rep.googleapis.com/", + "location": "europe-west10" } ], "fullyEncodeReservedExpansion": true, @@ -1655,7 +1675,7 @@ } } }, - "revision": "20250207", + "revision": "20250307", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -1824,6 +1844,26 @@ }, "type": "object" }, + "BaseImage": { + "description": "BaseImage describes a base image of a container image.", + "id": "BaseImage", + "properties": { + "layerCount": { + "description": "The number of layers that the base image is composed of.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "The name of the base image.", + "type": "string" + }, + "repository": { + "description": "The repository name in which the base image is from.", + "type": "string" + } + }, + "type": "object" + }, "BatchCreateNotesRequest": { "description": "Request to create notes in batch.", "id": "BatchCreateNotesRequest", @@ -2058,7 +2098,7 @@ "type": "object" }, "BuildStep": { - "description": "A step in the build pipeline. Next ID: 21", + "description": "A step in the build pipeline. Next ID: 22", "id": "BuildStep", "properties": { "allowExitCodes": { @@ -2116,6 +2156,12 @@ "$ref": "TimeSpan", "description": "Output only. Stores timing information for pulling this build step's builder image only." }, + "results": { + "items": { + "$ref": "StepResult" + }, + "type": "array" + }, "script": { "description": "A shell script to be executed in the step. When script is provided, the user cannot specify the entrypoint or args.", "type": "string" @@ -4742,6 +4788,10 @@ "filePath": { "description": "For jars that are contained inside .war files, this filepath can indicate the path to war file combined with the path to jar file.", "type": "string" + }, + "layerDetails": { + "$ref": "LayerDetails", + "description": "Each package found in a file should have its own layer metadata (that is, information from the origin layer of the package)." } }, "type": "object" @@ -5086,6 +5136,33 @@ }, "type": "object" }, + "LayerDetails": { + "description": "Details about the layer a package was found in.", + "id": "LayerDetails", + "properties": { + "baseImages": { + "description": "The base images the layer is found within.", + "items": { + "$ref": "BaseImage" + }, + "type": "array" + }, + "command": { + "description": "The layer build command that was used to build the layer. This may not be found in all layers depending on how the container image is built.", + "type": "string" + }, + "diffId": { + "description": "The diff ID (typically a sha256 hash) of the layer in the container image.", + "type": "string" + }, + "index": { + "description": "The index of the layer in the container image.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "License": { "description": "License information.", "id": "License", @@ -6311,6 +6388,22 @@ }, "type": "object" }, + "StepResult": { + "description": "StepResult is the declaration of a result for a build step.", + "id": "StepResult", + "properties": { + "attestationContentName": { + "type": "string" + }, + "attestationType": { + "type": "string" + }, + "name": { + "type": "string" + } + }, + "type": "object" + }, "Subject": { "id": "Subject", "properties": { diff --git a/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index aded60b34c..4d4931e895 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -490,6 +490,32 @@ func (s AttestationOccurrence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BaseImage: BaseImage describes a base image of a container image. +type BaseImage struct { + // LayerCount: The number of layers that the base image is composed of. + LayerCount int64 `json:"layerCount,omitempty"` + // Name: The name of the base image. + Name string `json:"name,omitempty"` + // Repository: The repository name in which the base image is from. + Repository string `json:"repository,omitempty"` + // ForceSendFields is a list of field names (e.g. "LayerCount") 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. "LayerCount") 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 BaseImage) MarshalJSON() ([]byte, error) { + type NoMethod BaseImage + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BatchCreateNotesRequest: Request to create notes in batch. type BatchCreateNotesRequest struct { // Notes: Required. The notes to create. Max allowed length is 1000. @@ -849,7 +875,7 @@ func (s BuildProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BuildStep: A step in the build pipeline. Next ID: 21 +// BuildStep: A step in the build pipeline. Next ID: 22 type BuildStep struct { // AllowExitCodes: Allow this build step to fail without failing the entire // build if and only if the exit code is one of the specified codes. If @@ -907,7 +933,8 @@ type BuildStep struct { Name string `json:"name,omitempty"` // PullTiming: Output only. Stores timing information for pulling this build // step's builder image only. - PullTiming *TimeSpan `json:"pullTiming,omitempty"` + PullTiming *TimeSpan `json:"pullTiming,omitempty"` + Results []*StepResult `json:"results,omitempty"` // Script: A shell script to be executed in the step. When script is provided, // the user cannot specify the entrypoint or args. Script string `json:"script,omitempty"` @@ -3888,6 +3915,9 @@ type GrafeasV1FileLocation struct { // FilePath: For jars that are contained inside .war files, this filepath can // indicate the path to war file combined with the path to jar file. FilePath string `json:"filePath,omitempty"` + // LayerDetails: Each package found in a file should have its own layer + // metadata (that is, information from the origin layer of the package). + LayerDetails *LayerDetails `json:"layerDetails,omitempty"` // ForceSendFields is a list of field names (e.g. "FilePath") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4391,6 +4421,36 @@ func (s Layer) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LayerDetails: Details about the layer a package was found in. +type LayerDetails struct { + // BaseImages: The base images the layer is found within. + BaseImages []*BaseImage `json:"baseImages,omitempty"` + // Command: The layer build command that was used to build the layer. This may + // not be found in all layers depending on how the container image is built. + Command string `json:"command,omitempty"` + // DiffId: The diff ID (typically a sha256 hash) of the layer in the container + // image. + DiffId string `json:"diffId,omitempty"` + // Index: The index of the layer in the container image. + Index int64 `json:"index,omitempty"` + // ForceSendFields is a list of field names (e.g. "BaseImages") 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. "BaseImages") 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 LayerDetails) MarshalJSON() ([]byte, error) { + type NoMethod LayerDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // License: License information. type License struct { // Comments: Comments @@ -5874,6 +5934,29 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StepResult: StepResult is the declaration of a result for a build step. +type StepResult struct { + AttestationContentName string `json:"attestationContentName,omitempty"` + AttestationType string `json:"attestationType,omitempty"` + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttestationContentName") 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. "AttestationContentName") 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 StepResult) MarshalJSON() ([]byte, error) { + type NoMethod StepResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Subject struct { // Digest: "": "" Algorithms can be e.g. sha256, sha512 See // https://github.com/in-toto/attestation/blob/main/spec/field_types.md#DigestSet diff --git a/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index e2344e75bf..e3bafa7d16 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -200,6 +200,26 @@ "description": "Regional Endpoint", "endpointUrl": "https://containeranalysis.us-west4.rep.googleapis.com/", "location": "us-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.europe-west10.rep.googleapis.com/", + "location": "europe-west10" } ], "fullyEncodeReservedExpansion": true, @@ -1420,7 +1440,7 @@ } } }, - "revision": "20250207", + "revision": "20250307", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -1561,6 +1581,26 @@ }, "type": "object" }, + "BaseImage": { + "description": "BaseImage describes a base image of a container image.", + "id": "BaseImage", + "properties": { + "layerCount": { + "description": "The number of layers that the base image is composed of.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "The name of the base image.", + "type": "string" + }, + "repository": { + "description": "The repository name in which the base image is from.", + "type": "string" + } + }, + "type": "object" + }, "Basis": { "description": "Basis describes the base image portion (Note) of the DockerImage relationship. Linked occurrences are derived from this or an equivalent image via: FROM Or an equivalent reference, e.g. a tag of the resource_url.", "id": "Basis", @@ -1776,7 +1816,7 @@ "type": "object" }, "BuildStep": { - "description": "A step in the build pipeline. Next ID: 21", + "description": "A step in the build pipeline. Next ID: 22", "id": "BuildStep", "properties": { "allowExitCodes": { @@ -1834,6 +1874,12 @@ "$ref": "TimeSpan", "description": "Output only. Stores timing information for pulling this build step's builder image only." }, + "results": { + "items": { + "$ref": "StepResult" + }, + "type": "array" + }, "script": { "description": "A shell script to be executed in the step. When script is provided, the user cannot specify the entrypoint or args.", "type": "string" @@ -4306,6 +4352,10 @@ "filePath": { "description": "For jars that are contained inside .war files, this filepath can indicate the path to war file combined with the path to jar file.", "type": "string" + }, + "layerDetails": { + "$ref": "LayerDetails", + "description": "Each package found in a file should have its own layer metadata (that is, information from the origin layer of the package)." } }, "type": "object" @@ -5018,6 +5068,33 @@ }, "type": "object" }, + "LayerDetails": { + "description": "Details about the layer a package was found in.", + "id": "LayerDetails", + "properties": { + "baseImages": { + "description": "The base images the layer is found within.", + "items": { + "$ref": "BaseImage" + }, + "type": "array" + }, + "command": { + "description": "The layer build command that was used to build the layer. This may not be found in all layers depending on how the container image is built.", + "type": "string" + }, + "diffId": { + "description": "The diff ID (sha256 hash) of the layer in the container image.", + "type": "string" + }, + "index": { + "description": "The index of the layer in the container image.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "License": { "description": "License information.", "id": "License", @@ -6704,6 +6781,22 @@ }, "type": "object" }, + "StepResult": { + "description": "StepResult is the declaration of a result for a build step.", + "id": "StepResult", + "properties": { + "attestationContentName": { + "type": "string" + }, + "attestationType": { + "type": "string" + }, + "name": { + "type": "string" + } + }, + "type": "object" + }, "StorageSource": { "description": "StorageSource describes the location of the source in an archive file in Google Cloud Storage.", "id": "StorageSource", diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index a111849bc7..7895385813 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -467,6 +467,32 @@ func (s AttestationAuthorityHint) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BaseImage: BaseImage describes a base image of a container image. +type BaseImage struct { + // LayerCount: The number of layers that the base image is composed of. + LayerCount int64 `json:"layerCount,omitempty"` + // Name: The name of the base image. + Name string `json:"name,omitempty"` + // Repository: The repository name in which the base image is from. + Repository string `json:"repository,omitempty"` + // ForceSendFields is a list of field names (e.g. "LayerCount") 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. "LayerCount") 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 BaseImage) MarshalJSON() ([]byte, error) { + type NoMethod BaseImage + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Basis: Basis describes the base image portion (Note) of the DockerImage // relationship. Linked occurrences are derived from this or an equivalent // image via: FROM Or an equivalent reference, e.g. a tag of the resource_url. @@ -781,7 +807,7 @@ func (s BuildSignature) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BuildStep: A step in the build pipeline. Next ID: 21 +// BuildStep: A step in the build pipeline. Next ID: 22 type BuildStep struct { // AllowExitCodes: Allow this build step to fail without failing the entire // build if and only if the exit code is one of the specified codes. If @@ -839,7 +865,8 @@ type BuildStep struct { Name string `json:"name,omitempty"` // PullTiming: Output only. Stores timing information for pulling this build // step's builder image only. - PullTiming *TimeSpan `json:"pullTiming,omitempty"` + PullTiming *TimeSpan `json:"pullTiming,omitempty"` + Results []*StepResult `json:"results,omitempty"` // Script: A shell script to be executed in the step. When script is provided, // the user cannot specify the entrypoint or args. Script string `json:"script,omitempty"` @@ -3647,6 +3674,9 @@ type FileLocation struct { // FilePath: For jars that are contained inside .war files, this filepath can // indicate the path to war file combined with the path to jar file. FilePath string `json:"filePath,omitempty"` + // LayerDetails: Each package found in a file should have its own layer + // metadata (that is, information from the origin layer of the package). + LayerDetails *LayerDetails `json:"layerDetails,omitempty"` // ForceSendFields is a list of field names (e.g. "FilePath") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4564,6 +4594,35 @@ func (s Layer) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LayerDetails: Details about the layer a package was found in. +type LayerDetails struct { + // BaseImages: The base images the layer is found within. + BaseImages []*BaseImage `json:"baseImages,omitempty"` + // Command: The layer build command that was used to build the layer. This may + // not be found in all layers depending on how the container image is built. + Command string `json:"command,omitempty"` + // DiffId: The diff ID (sha256 hash) of the layer in the container image. + DiffId string `json:"diffId,omitempty"` + // Index: The index of the layer in the container image. + Index int64 `json:"index,omitempty"` + // ForceSendFields is a list of field names (e.g. "BaseImages") 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. "BaseImages") 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 LayerDetails) MarshalJSON() ([]byte, error) { + type NoMethod LayerDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // License: License information. type License struct { // Comments: Comments @@ -6501,6 +6560,29 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StepResult: StepResult is the declaration of a result for a build step. +type StepResult struct { + AttestationContentName string `json:"attestationContentName,omitempty"` + AttestationType string `json:"attestationType,omitempty"` + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttestationContentName") 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. "AttestationContentName") 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 StepResult) MarshalJSON() ([]byte, error) { + type NoMethod StepResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // StorageSource: StorageSource describes the location of the source in an // archive file in Google Cloud Storage. type StorageSource struct { diff --git a/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index 17ed84aa05..ab6b76aa73 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -200,6 +200,26 @@ "description": "Regional Endpoint", "endpointUrl": "https://containeranalysis.us-west4.rep.googleapis.com/", "location": "us-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://containeranalysis.europe-west10.rep.googleapis.com/", + "location": "europe-west10" } ], "fullyEncodeReservedExpansion": true, @@ -1711,7 +1731,7 @@ } } }, - "revision": "20250207", + "revision": "20250307", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -2151,7 +2171,7 @@ "type": "object" }, "BuildStep": { - "description": "A step in the build pipeline. Next ID: 21", + "description": "A step in the build pipeline. Next ID: 22", "id": "BuildStep", "properties": { "allowExitCodes": { @@ -2209,6 +2229,12 @@ "$ref": "TimeSpan", "description": "Output only. Stores timing information for pulling this build step's builder image only." }, + "results": { + "items": { + "$ref": "StepResult" + }, + "type": "array" + }, "script": { "description": "A shell script to be executed in the step. When script is provided, the user cannot specify the entrypoint or args.", "type": "string" @@ -6809,6 +6835,22 @@ }, "type": "object" }, + "StepResult": { + "description": "StepResult is the declaration of a result for a build step.", + "id": "StepResult", + "properties": { + "attestationContentName": { + "type": "string" + }, + "attestationType": { + "type": "string" + }, + "name": { + "type": "string" + } + }, + "type": "object" + }, "Subject": { "description": "Set of software artifacts that the attestation applies to. Each element represents a single software artifact.", "id": "Subject", diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index d90ac42750..1405ea8c7c 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -911,7 +911,7 @@ func (s BuildSignature) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BuildStep: A step in the build pipeline. Next ID: 21 +// BuildStep: A step in the build pipeline. Next ID: 22 type BuildStep struct { // AllowExitCodes: Allow this build step to fail without failing the entire // build if and only if the exit code is one of the specified codes. If @@ -969,7 +969,8 @@ type BuildStep struct { Name string `json:"name,omitempty"` // PullTiming: Output only. Stores timing information for pulling this build // step's builder image only. - PullTiming *TimeSpan `json:"pullTiming,omitempty"` + PullTiming *TimeSpan `json:"pullTiming,omitempty"` + Results []*StepResult `json:"results,omitempty"` // Script: A shell script to be executed in the step. When script is provided, // the user cannot specify the entrypoint or args. Script string `json:"script,omitempty"` @@ -6264,6 +6265,29 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StepResult: StepResult is the declaration of a result for a build step. +type StepResult struct { + AttestationContentName string `json:"attestationContentName,omitempty"` + AttestationType string `json:"attestationType,omitempty"` + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttestationContentName") 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. "AttestationContentName") 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 StepResult) MarshalJSON() ([]byte, error) { + type NoMethod StepResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Subject: Set of software artifacts that the attestation applies to. Each // element represents a single software artifact. type Subject struct { diff --git a/dataform/v1beta1/dataform-api.json b/dataform/v1beta1/dataform-api.json index 1067ca829d..d0f6b1d1fc 100644 --- a/dataform/v1beta1/dataform-api.json +++ b/dataform/v1beta1/dataform-api.json @@ -206,7 +206,7 @@ ] }, "updateConfig": { - "description": "Update default config for a given project and location. **Note:** This method does not fully implement [AIP-134](https://google.aip.dev/134); in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", + "description": "Update default config for a given project and location. **Note:** *This method does not fully implement*, (see [AIP/134](https://google.aip.dev/134), in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/config", "httpMethod": "PATCH", "id": "dataform.projects.locations.updateConfig", @@ -533,7 +533,7 @@ ] }, "patch": { - "description": "Updates a single Repository. **Note:** This method does not fully implement [AIP-134](https://google.aip.dev/134); in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", + "description": "Updates a single Repository. **Note:** *This method does not fully implement*, (see [AIP/134](https://google.aip.dev/134), in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "httpMethod": "PATCH", "id": "dataform.projects.locations.repositories.patch", @@ -984,7 +984,7 @@ ] }, "patch": { - "description": "Updates a single ReleaseConfig. **Note:** This method does not fully implement [AIP-134](https://google.aip.dev/134); in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", + "description": "Updates a single ReleaseConfig. **Note:** *This method does not fully implement*, (see [AIP/134](https://google.aip.dev/134), in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "httpMethod": "PATCH", "id": "dataform.projects.locations.repositories.releaseConfigs.patch", @@ -1146,7 +1146,7 @@ ] }, "patch": { - "description": "Updates a single WorkflowConfig. **Note:** This method does not fully implement [AIP-134](https://google.aip.dev/134); in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", + "description": "Updates a single WorkflowConfig. **Note:** *This method does not fully implement*, (see [AIP/134](https://google.aip.dev/134), in particular: - The wildcard entry (**\\***) is treated as a bad request - When the **field_mask** is omitted, instead of only updating the set fields, the request is treated as a full update on all modifiable fields", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "httpMethod": "PATCH", "id": "dataform.projects.locations.repositories.workflowConfigs.patch", @@ -2141,7 +2141,7 @@ } } }, - "revision": "20250302", + "revision": "20250306", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "Assertion": { diff --git a/dataform/v1beta1/dataform-gen.go b/dataform/v1beta1/dataform-gen.go index c94372899a..bc2812c9bf 100644 --- a/dataform/v1beta1/dataform-gen.go +++ b/dataform/v1beta1/dataform-gen.go @@ -3475,8 +3475,8 @@ type ProjectsLocationsUpdateConfigCall struct { } // UpdateConfig: Update default config for a given project and location. -// **Note:** This method does not fully implement AIP-134 -// (https://google.aip.dev/134); in particular: - The wildcard entry (**\***) +// **Note:** *This method does not fully implement*, (see AIP/134 +// (https://google.aip.dev/134), in particular: - The wildcard entry (**\***) // is treated as a bad request - When the **field_mask** is omitted, instead of // only updating the set fields, the request is treated as a full update on all // modifiable fields @@ -4683,8 +4683,8 @@ type ProjectsLocationsRepositoriesPatchCall struct { header_ http.Header } -// Patch: Updates a single Repository. **Note:** This method does not fully -// implement AIP-134 (https://google.aip.dev/134); in particular: - The +// Patch: Updates a single Repository. **Note:** *This method does not fully +// implement*, (see AIP/134 (https://google.aip.dev/134), in particular: - The // wildcard entry (**\***) is treated as a bad request - When the // **field_mask** is omitted, instead of only updating the set fields, the // request is treated as a full update on all modifiable fields @@ -6310,8 +6310,8 @@ type ProjectsLocationsRepositoriesReleaseConfigsPatchCall struct { header_ http.Header } -// Patch: Updates a single ReleaseConfig. **Note:** This method does not fully -// implement AIP-134 (https://google.aip.dev/134); in particular: - The +// Patch: Updates a single ReleaseConfig. **Note:** *This method does not fully +// implement*, (see AIP/134 (https://google.aip.dev/134), in particular: - The // wildcard entry (**\***) is treated as a bad request - When the // **field_mask** is omitted, instead of only updating the set fields, the // request is treated as a full update on all modifiable fields @@ -6892,9 +6892,9 @@ type ProjectsLocationsRepositoriesWorkflowConfigsPatchCall struct { header_ http.Header } -// Patch: Updates a single WorkflowConfig. **Note:** This method does not fully -// implement AIP-134 (https://google.aip.dev/134); in particular: - The -// wildcard entry (**\***) is treated as a bad request - When the +// Patch: Updates a single WorkflowConfig. **Note:** *This method does not +// fully implement*, (see AIP/134 (https://google.aip.dev/134), in particular: +// - The wildcard entry (**\***) is treated as a bad request - When the // **field_mask** is omitted, instead of only updating the set fields, the // request is treated as a full update on all modifiable fields // diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 7864579e01..e0fd17163b 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -6257,7 +6257,7 @@ } } }, - "revision": "20250222", + "revision": "20250307", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -7440,7 +7440,7 @@ "id": "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing", "properties": { "dataset": { - "description": "Output only. The BigQuery dataset to publish to. It takes the form projects/{project_id}/datasets/{dataset_id}. If not set, the service creates a default publishing dataset.", + "description": "Output only. The BigQuery dataset the discovered tables are published to.", "readOnly": true, "type": "string" } diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 4f369168e1..2eb7611968 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -1885,9 +1885,8 @@ func (s GoogleCloudDataplexV1DataDiscoveryResult) MarshalJSON() ([]byte, error) // GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing: Describes // BigQuery publishing configurations. type GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing struct { - // Dataset: Output only. The BigQuery dataset to publish to. It takes the form - // projects/{project_id}/datasets/{dataset_id}. If not set, the service creates - // a default publishing dataset. + // Dataset: Output only. The BigQuery dataset the discovered tables are + // published to. Dataset string `json:"dataset,omitempty"` // ForceSendFields is a list of field names (e.g. "Dataset") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/dataproc/v1/dataproc-api.json b/dataproc/v1/dataproc-api.json index b3aed7ac22..758736a2a7 100644 --- a/dataproc/v1/dataproc-api.json +++ b/dataproc/v1/dataproc-api.json @@ -680,6 +680,72 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "accessNativeBuildInfo": { + "description": "Obtain build data for Native Job", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/batches/{batchesId}/sparkApplications/{sparkApplicationsId}:accessNativeBuildInfo", + "httpMethod": "GET", + "id": "dataproc.projects.locations.batches.sparkApplications.accessNativeBuildInfo", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The fully qualified name of the batch to retrieve in the format \"projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplications/APPLICATION_ID\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/batches/[^/]+/sparkApplications/[^/]+$", + "required": true, + "type": "string" + }, + "parent": { + "description": "Required. Parent (Batch) resource reference.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:accessNativeBuildInfo", + "response": { + "$ref": "AccessSparkApplicationNativeBuildInfoResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "accessNativeSqlQuery": { + "description": "Obtain data corresponding to a particular Native SQL Query for a Spark Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/batches/{batchesId}/sparkApplications/{sparkApplicationsId}:accessNativeSqlQuery", + "httpMethod": "GET", + "id": "dataproc.projects.locations.batches.sparkApplications.accessNativeSqlQuery", + "parameterOrder": [ + "name" + ], + "parameters": { + "executionId": { + "description": "Required. Execution ID", + "format": "int64", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The fully qualified name of the batch to retrieve in the format \"projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplications/APPLICATION_ID\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/batches/[^/]+/sparkApplications/[^/]+$", + "required": true, + "type": "string" + }, + "parent": { + "description": "Required. Parent (Batch) resource reference.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:accessNativeSqlQuery", + "response": { + "$ref": "AccessSparkApplicationNativeSqlQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "accessSqlPlan": { "description": "Obtain Spark Plan Graph for a Spark Application SQL execution. Limits the number of clusters returned as part of the graph to 10000.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/batches/{batchesId}/sparkApplications/{sparkApplicationsId}:accessSqlPlan", @@ -1090,6 +1156,47 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "searchNativeSqlQueries": { + "description": "Obtain data corresponding to Native SQL Queries for a Spark Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/batches/{batchesId}/sparkApplications/{sparkApplicationsId}:searchNativeSqlQueries", + "httpMethod": "GET", + "id": "dataproc.projects.locations.batches.sparkApplications.searchNativeSqlQueries", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The fully qualified name of the batch to retrieve in the format \"projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplications/APPLICATION_ID\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/batches/[^/]+/sparkApplications/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of queries to return in each response. The service may return fewer than this. The default page size is 10; the maximum page size is 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token received from a previous SearchSparkApplicationNativeSqlQueries call. Provide this token to retrieve the subsequent page.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent (Batch) resource reference.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:searchNativeSqlQueries", + "response": { + "$ref": "SearchSparkApplicationNativeSqlQueriesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "searchSqlQueries": { "description": "Obtain data corresponding to SQL Queries for a Spark Application.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/batches/{batchesId}/sparkApplications/{sparkApplicationsId}:searchSqlQueries", @@ -2040,6 +2147,72 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "accessNativeBuildInfo": { + "description": "Obtain data corresponding to Native Build Information for a Spark Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sessions/{sessionsId}/sparkApplications/{sparkApplicationsId}:accessNativeBuildInfo", + "httpMethod": "GET", + "id": "dataproc.projects.locations.sessions.sparkApplications.accessNativeBuildInfo", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The fully qualified name of the session to retrieve in the format \"projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApplications/APPLICATION_ID\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/sessions/[^/]+/sparkApplications/[^/]+$", + "required": true, + "type": "string" + }, + "parent": { + "description": "Required. Parent (Session) resource reference.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:accessNativeBuildInfo", + "response": { + "$ref": "AccessSessionSparkApplicationNativeBuildInfoResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "accessNativeSqlQuery": { + "description": "Obtain data corresponding to a particular Native SQL Query for a Spark Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sessions/{sessionsId}/sparkApplications/{sparkApplicationsId}:accessNativeSqlQuery", + "httpMethod": "GET", + "id": "dataproc.projects.locations.sessions.sparkApplications.accessNativeSqlQuery", + "parameterOrder": [ + "name" + ], + "parameters": { + "executionId": { + "description": "Required. Execution ID", + "format": "int64", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The fully qualified name of the session to retrieve in the format \"projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApplications/APPLICATION_ID\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/sessions/[^/]+/sparkApplications/[^/]+$", + "required": true, + "type": "string" + }, + "parent": { + "description": "Required. Parent (Session) resource reference.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:accessNativeSqlQuery", + "response": { + "$ref": "AccessSessionSparkApplicationNativeSqlQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "accessSqlPlan": { "description": "Obtain Spark Plan Graph for a Spark Application SQL execution. Limits the number of clusters returned as part of the graph to 10000.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sessions/{sessionsId}/sparkApplications/{sparkApplicationsId}:accessSqlPlan", @@ -2450,6 +2623,47 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "searchNativeSqlQueries": { + "description": "Obtain data corresponding to Native SQL Queries for a Spark Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sessions/{sessionsId}/sparkApplications/{sparkApplicationsId}:searchNativeSqlQueries", + "httpMethod": "GET", + "id": "dataproc.projects.locations.sessions.sparkApplications.searchNativeSqlQueries", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The fully qualified name of the session to retrieve in the format \"projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApplications/APPLICATION_ID\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/sessions/[^/]+/sparkApplications/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of queries to return in each response. The service may return fewer than this. The default page size is 10; the maximum page size is 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token received from a previous SearchSessionSparkApplicationSqlQueries call. Provide this token to retrieve the subsequent page.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent (Session) resource reference.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:searchNativeSqlQueries", + "response": { + "$ref": "SearchSessionSparkApplicationNativeSqlQueriesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "searchSqlQueries": { "description": "Obtain data corresponding to SQL Queries for a Spark Application.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sessions/{sessionsId}/sparkApplications/{sparkApplicationsId}:searchSqlQueries", @@ -4978,7 +5192,7 @@ } } }, - "revision": "20250207", + "revision": "20250315", "rootUrl": "https://dataproc.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -5020,6 +5234,28 @@ }, "type": "object" }, + "AccessSessionSparkApplicationNativeBuildInfoResponse": { + "description": "Details of a native build info for a Spark Application", + "id": "AccessSessionSparkApplicationNativeBuildInfoResponse", + "properties": { + "executionData": { + "$ref": "NativeBuildInfoUiData", + "description": "Native SQL Execution Data" + } + }, + "type": "object" + }, + "AccessSessionSparkApplicationNativeSqlQueryResponse": { + "description": "Details of a native query for a Spark Application", + "id": "AccessSessionSparkApplicationNativeSqlQueryResponse", + "properties": { + "executionData": { + "$ref": "NativeSqlExecutionUiData", + "description": "Native SQL Execution Data" + } + }, + "type": "object" + }, "AccessSessionSparkApplicationResponse": { "description": "A summary of Spark Application", "id": "AccessSessionSparkApplicationResponse", @@ -5100,6 +5336,28 @@ }, "type": "object" }, + "AccessSparkApplicationNativeBuildInfoResponse": { + "description": "Details of Native Build Info for a Spark Application", + "id": "AccessSparkApplicationNativeBuildInfoResponse", + "properties": { + "buildInfo": { + "$ref": "NativeBuildInfoUiData", + "description": "Native Build Info Data" + } + }, + "type": "object" + }, + "AccessSparkApplicationNativeSqlQueryResponse": { + "description": "Details of a query for a Spark Application", + "id": "AccessSparkApplicationNativeSqlQueryResponse", + "properties": { + "executionData": { + "$ref": "NativeSqlExecutionUiData", + "description": "Native SQL Execution Data" + } + }, + "type": "object" + }, "AccessSparkApplicationResponse": { "description": "A summary of Spark Application", "id": "AccessSparkApplicationResponse", @@ -5404,6 +5662,27 @@ }, "type": "object" }, + "AuthenticationConfig": { + "description": "Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).", + "id": "AuthenticationConfig", + "properties": { + "userWorkloadAuthenticationType": { + "description": "Optional. Authentication type for the user workload running in containers.", + "enum": [ + "AUTHENTICATION_TYPE_UNSPECIFIED", + "SERVICE_ACCOUNT", + "END_USER_CREDENTIALS" + ], + "enumDescriptions": [ + "If AuthenticationType is unspecified then END_USER_CREDENTIALS is used for 3.0 and newer runtimes, and SERVICE_ACCOUNT is used for older runtimes.", + "Use service account credentials for authenticating to other services.", + "Use OAuth credentials associated with the workload creator/user for authenticating to other services." + ], + "type": "string" + } + }, + "type": "object" + }, "AutoscalingConfig": { "description": "Autoscaling Policy config associated with the cluster.", "id": "AutoscalingConfig", @@ -6428,6 +6707,10 @@ "description": "Execution configuration for a workload.", "id": "ExecutionConfig", "properties": { + "authenticationConfig": { + "$ref": "AuthenticationConfig", + "description": "Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s)." + }, "idleTtl": { "description": "Optional. Applies to sessions only. The duration to keep the session alive while it's idling. Exceeding this threshold causes the session to terminate. This field cannot be set on a batch workload. Minimum value is 10 minutes; maximum value is 14 days (see JSON representation of Duration (https://developers.google.com/protocol-buffers/docs/proto3#json)). Defaults to 1 hour if not set. If both ttl and idle_ttl are specified for an interactive session, the conditions are treated as OR conditions: the workload will be terminated when it has been idle for idle_ttl or when ttl has been exceeded, whichever occurs first.", "format": "google-duration", @@ -6972,7 +7255,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Resource manager tags to add to all instances (see Resource manager tags resources (https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing)).", + "description": "Optional. Resource manager tags (https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing) to add to all instances (see Use secure tags in Dataproc (https://cloud.google.com/dataproc/docs/guides/attach-secure-tags)).", "type": "object" }, "serviceAccount": { @@ -8453,7 +8736,7 @@ "id": "Metric", "properties": { "metricOverrides": { - "description": "Optional. Specify one or more Custom metrics (https://cloud.google.com/dataproc/docs/guides/dataproc-metrics#custom_metrics) to collect for the metric course (for the SPARK metric source (any Spark metric (https://spark.apache.org/docs/latest/monitoring.html#metrics) can be specified).Provide metrics in the following format: METRIC_SOURCE: INSTANCE:GROUP:METRIC Use camelcase as appropriate.Examples: yarn:ResourceManager:QueueMetrics:AppsCompleted spark:driver:DAGScheduler:job.allJobs sparkHistoryServer:JVM:Memory:NonHeapMemoryUsage.committed hiveserver2:JVM:Memory:NonHeapMemoryUsage.used Notes: Only the specified overridden metrics are collected for the metric source. For example, if one or more spark:executive metrics are listed as metric overrides, other SPARK metrics are not collected. The collection of the metrics for other enabled custom metric sources is unaffected. For example, if both SPARK andd YARN metric sources are enabled, and overrides are provided for Spark metrics only, all YARN metrics are collected.", + "description": "Optional. Specify one or more Custom metrics (https://cloud.google.com/dataproc/docs/guides/dataproc-metrics#custom_metrics) to collect for the metric course (for the SPARK metric source (any Spark metric (https://spark.apache.org/docs/latest/monitoring.html#metrics) can be specified).Provide metrics in the following format: METRIC_SOURCE: INSTANCE:GROUP:METRIC Use camelcase as appropriate.Examples: yarn:ResourceManager:QueueMetrics:AppsCompleted spark:driver:DAGScheduler:job.allJobs sparkHistoryServer:JVM:Memory:NonHeapMemoryUsage.committed hiveserver2:JVM:Memory:NonHeapMemoryUsage.used Notes: Only the specified overridden metrics are collected for the metric source. For example, if one or more spark:executive metrics are listed as metric overrides, other SPARK metrics are not collected. The collection of the metrics for other enabled custom metric sources is unaffected. For example, if both SPARK and YARN metric sources are enabled, and overrides are provided for Spark metrics only, all YARN metrics are collected.", "items": { "type": "string" }, @@ -8644,7 +8927,8 @@ "REPAIR", "UPDATE_LABELS", "START", - "STOP" + "STOP", + "UPDATE_METADATA_CONFIG" ], "enumDescriptions": [ "Node group operation type is unknown.", @@ -8655,7 +8939,8 @@ "Repair node group operation type.", "Update node group label operation type.", "Start node group operation type.", - "Stop node group operation type." + "Stop node group operation type.", + "This operation type is used to update the metadata config of a node group. We update the metadata of the VMs in the node group and await for intended config change to be completed at the node group level. Currently, only the identity config update is supported." ], "type": "string" }, @@ -9760,6 +10045,25 @@ }, "type": "object" }, + "SearchSessionSparkApplicationNativeSqlQueriesResponse": { + "description": "List of all Native queries for a Spark Application.", + "id": "SearchSessionSparkApplicationNativeSqlQueriesResponse", + "properties": { + "nextPageToken": { + "description": "This token is included in the response if there are more results to fetch. To fetch additional results, provide this value as the page_token in a subsequent SearchSessionSparkApplicationSqlQueriesRequest.", + "type": "string" + }, + "sparkApplicationNativeSqlQueries": { + "description": "Output only. Native SQL Execution Data", + "items": { + "$ref": "NativeSqlExecutionUiData" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "SearchSessionSparkApplicationSqlQueriesResponse": { "description": "List of all queries for a Spark Application.", "id": "SearchSessionSparkApplicationSqlQueriesResponse", @@ -9910,6 +10214,25 @@ }, "type": "object" }, + "SearchSparkApplicationNativeSqlQueriesResponse": { + "description": "List of all Native SQL queries details for a Spark Application.", + "id": "SearchSparkApplicationNativeSqlQueriesResponse", + "properties": { + "nextPageToken": { + "description": "This token is included in the response if there are more results to fetch. To fetch additional results, provide this value as the page_token in a subsequent SearchSparkApplicationNativeSqlQueriesRequest.", + "type": "string" + }, + "sparkApplicationNativeSqlQueries": { + "description": "Output only. Native SQL Execution Data", + "items": { + "$ref": "NativeSqlExecutionUiData" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "SearchSparkApplicationSqlQueriesResponse": { "description": "List of all queries for a Spark Application.", "id": "SearchSparkApplicationSqlQueriesResponse", @@ -10531,12 +10854,14 @@ "enum": [ "COMPONENT_UNSPECIFIED", "ANACONDA", + "DELTA", "DOCKER", "DRUID", "FLINK", "HBASE", "HIVE_WEBHCAT", "HUDI", + "ICEBERG", "JUPYTER", "PIG", "PRESTO", @@ -10549,12 +10874,14 @@ "enumDescriptions": [ "Unspecified component. Specifying this will cause Cluster creation to fail.", "The Anaconda component is no longer supported or applicable to supported Dataproc on Compute Engine image versions (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-version-clusters#supported-dataproc-image-versions). It cannot be activated on clusters created with supported Dataproc on Compute Engine image versions.", + "Delta Lake.", "Docker", "The Druid query engine. (alpha)", "Flink", "HBase. (beta)", "The Hive Web HCatalog (the REST service for accessing HCatalog).", "Hudi.", + "Iceberg.", "The Jupyter Notebook.", "The Pig component.", "The Presto query engine.", @@ -12447,10 +12774,20 @@ "format": "int64", "type": "string" }, + "milliSlotSeconds": { + "description": "Optional. Slot usage in (milliSlot x seconds).", + "format": "int64", + "type": "string" + }, "shuffleStorageGbSeconds": { "description": "Optional. Shuffle storage usage in (GB x seconds) (see Dataproc Serverless pricing (https://cloud.google.com/dataproc-serverless/pricing)).", "format": "int64", "type": "string" + }, + "updateTime": { + "description": "Optional. The timestamp of the usage metrics.", + "format": "google-datetime", + "type": "string" } }, "type": "object" @@ -12478,6 +12815,11 @@ "format": "int64", "type": "string" }, + "milliSlot": { + "description": "Optional. Milli (one-thousandth) Slot usage of the workload.", + "format": "int64", + "type": "string" + }, "shuffleStorageGb": { "description": "Optional. Shuffle Storage in gigabytes (GB). (see Dataproc Serverless pricing (https://cloud.google.com/dataproc-serverless/pricing))", "format": "int64", diff --git a/dataproc/v1/dataproc-gen.go b/dataproc/v1/dataproc-gen.go index cc30c3c45b..866fae9645 100644 --- a/dataproc/v1/dataproc-gen.go +++ b/dataproc/v1/dataproc-gen.go @@ -450,6 +450,58 @@ func (s AccessSessionSparkApplicationJobResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AccessSessionSparkApplicationNativeBuildInfoResponse: Details of a native +// build info for a Spark Application +type AccessSessionSparkApplicationNativeBuildInfoResponse struct { + // ExecutionData: Native SQL Execution Data + ExecutionData *NativeBuildInfoUiData `json:"executionData,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ExecutionData") 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. "ExecutionData") 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 AccessSessionSparkApplicationNativeBuildInfoResponse) MarshalJSON() ([]byte, error) { + type NoMethod AccessSessionSparkApplicationNativeBuildInfoResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AccessSessionSparkApplicationNativeSqlQueryResponse: Details of a native +// query for a Spark Application +type AccessSessionSparkApplicationNativeSqlQueryResponse struct { + // ExecutionData: Native SQL Execution Data + ExecutionData *NativeSqlExecutionUiData `json:"executionData,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ExecutionData") 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. "ExecutionData") 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 AccessSessionSparkApplicationNativeSqlQueryResponse) MarshalJSON() ([]byte, error) { + type NoMethod AccessSessionSparkApplicationNativeSqlQueryResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AccessSessionSparkApplicationResponse: A summary of Spark Application type AccessSessionSparkApplicationResponse struct { // Application: Output only. High level information corresponding to an @@ -633,6 +685,58 @@ func (s AccessSparkApplicationJobResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AccessSparkApplicationNativeBuildInfoResponse: Details of Native Build Info +// for a Spark Application +type AccessSparkApplicationNativeBuildInfoResponse struct { + // BuildInfo: Native Build Info Data + BuildInfo *NativeBuildInfoUiData `json:"buildInfo,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "BuildInfo") 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. "BuildInfo") 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 AccessSparkApplicationNativeBuildInfoResponse) MarshalJSON() ([]byte, error) { + type NoMethod AccessSparkApplicationNativeBuildInfoResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AccessSparkApplicationNativeSqlQueryResponse: Details of a query for a Spark +// Application +type AccessSparkApplicationNativeSqlQueryResponse struct { + // ExecutionData: Native SQL Execution Data + ExecutionData *NativeSqlExecutionUiData `json:"executionData,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ExecutionData") 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. "ExecutionData") 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 AccessSparkApplicationNativeSqlQueryResponse) MarshalJSON() ([]byte, error) { + type NoMethod AccessSparkApplicationNativeSqlQueryResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AccessSparkApplicationResponse: A summary of Spark Application type AccessSparkApplicationResponse struct { // Application: Output only. High level information corresponding to an @@ -972,6 +1076,42 @@ func (s ApplicationInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AuthenticationConfig: Authentication configuration for a workload is used to +// set the default identity for the workload execution. The config specifies +// the type of identity (service account or user) that will be used by +// workloads to access resources on the project(s). +type AuthenticationConfig struct { + // UserWorkloadAuthenticationType: Optional. Authentication type for the user + // workload running in containers. + // + // Possible values: + // "AUTHENTICATION_TYPE_UNSPECIFIED" - If AuthenticationType is unspecified + // then END_USER_CREDENTIALS is used for 3.0 and newer runtimes, and + // SERVICE_ACCOUNT is used for older runtimes. + // "SERVICE_ACCOUNT" - Use service account credentials for authenticating to + // other services. + // "END_USER_CREDENTIALS" - Use OAuth credentials associated with the + // workload creator/user for authenticating to other services. + UserWorkloadAuthenticationType string `json:"userWorkloadAuthenticationType,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "UserWorkloadAuthenticationType") 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. "UserWorkloadAuthenticationType") + // 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 AuthenticationConfig) MarshalJSON() ([]byte, error) { + type NoMethod AuthenticationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AutoscalingConfig: Autoscaling Policy config associated with the cluster. type AutoscalingConfig struct { // PolicyUri: Optional. The autoscaling policy used by the cluster.Only @@ -2213,6 +2353,11 @@ func (s EnvironmentConfig) MarshalJSON() ([]byte, error) { // ExecutionConfig: Execution configuration for a workload. type ExecutionConfig struct { + // AuthenticationConfig: Optional. Authentication configuration used to set the + // default identity for the workload execution. The config specifies the type + // of identity (service account or user) that will be used by workloads to + // access resources on the project(s). + AuthenticationConfig *AuthenticationConfig `json:"authenticationConfig,omitempty"` // IdleTtl: Optional. Applies to sessions only. The duration to keep the // session alive while it's idling. Exceeding this threshold causes the session // to terminate. This field cannot be set on a batch workload. Minimum value is @@ -2256,15 +2401,15 @@ type ExecutionConfig struct { // workload will be terminated when it has been idle for idle_ttl or when ttl // has been exceeded, whichever occurs first. Ttl string `json:"ttl,omitempty"` - // ForceSendFields is a list of field names (e.g. "IdleTtl") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "AuthenticationConfig") 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. "IdleTtl") 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. "AuthenticationConfig") 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:"-"` } @@ -2730,9 +2875,10 @@ type GceClusterConfig struct { // ReservationAffinity: Optional. Reservation Affinity for consuming Zonal // reservation. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` - // ResourceManagerTags: Optional. Resource manager tags to add to all instances - // (see Resource manager tags resources - // (https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing)). + // ResourceManagerTags: Optional. Resource manager tags + // (https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing) + // to add to all instances (see Use secure tags in Dataproc + // (https://cloud.google.com/dataproc/docs/guides/attach-secure-tags)). ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` // ServiceAccount: Optional. The Dataproc service account // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/service-accounts#service_accounts_in_dataproc) @@ -4591,7 +4737,7 @@ type Metric struct { // overridden metrics are collected for the metric source. For example, if one // or more spark:executive metrics are listed as metric overrides, other SPARK // metrics are not collected. The collection of the metrics for other enabled - // custom metric sources is unaffected. For example, if both SPARK andd YARN + // custom metric sources is unaffected. For example, if both SPARK and YARN // metric sources are enabled, and overrides are provided for Spark metrics // only, all YARN metrics are collected. MetricOverrides []string `json:"metricOverrides,omitempty"` @@ -4808,6 +4954,10 @@ type NodeGroupOperationMetadata struct { // "UPDATE_LABELS" - Update node group label operation type. // "START" - Start node group operation type. // "STOP" - Stop node group operation type. + // "UPDATE_METADATA_CONFIG" - This operation type is used to update the + // metadata config of a node group. We update the metadata of the VMs in the + // node group and await for intended config change to be completed at the node + // group level. Currently, only the identity config update is supported. OperationType string `json:"operationType,omitempty"` // Status: Output only. Current operation status. Status *ClusterOperationStatus `json:"status,omitempty"` @@ -6138,6 +6288,36 @@ func (s SearchSessionSparkApplicationJobsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SearchSessionSparkApplicationNativeSqlQueriesResponse: List of all Native +// queries for a Spark Application. +type SearchSessionSparkApplicationNativeSqlQueriesResponse struct { + // NextPageToken: This token is included in the response if there are more + // results to fetch. To fetch additional results, provide this value as the + // page_token in a subsequent SearchSessionSparkApplicationSqlQueriesRequest. + NextPageToken string `json:"nextPageToken,omitempty"` + // SparkApplicationNativeSqlQueries: Output only. Native SQL Execution Data + SparkApplicationNativeSqlQueries []*NativeSqlExecutionUiData `json:"sparkApplicationNativeSqlQueries,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 SearchSessionSparkApplicationNativeSqlQueriesResponse) MarshalJSON() ([]byte, error) { + type NoMethod SearchSessionSparkApplicationNativeSqlQueriesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SearchSessionSparkApplicationSqlQueriesResponse: List of all queries for a // Spark Application. type SearchSessionSparkApplicationSqlQueriesResponse struct { @@ -6384,6 +6564,36 @@ func (s SearchSparkApplicationJobsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SearchSparkApplicationNativeSqlQueriesResponse: List of all Native SQL +// queries details for a Spark Application. +type SearchSparkApplicationNativeSqlQueriesResponse struct { + // NextPageToken: This token is included in the response if there are more + // results to fetch. To fetch additional results, provide this value as the + // page_token in a subsequent SearchSparkApplicationNativeSqlQueriesRequest. + NextPageToken string `json:"nextPageToken,omitempty"` + // SparkApplicationNativeSqlQueries: Output only. Native SQL Execution Data + SparkApplicationNativeSqlQueries []*NativeSqlExecutionUiData `json:"sparkApplicationNativeSqlQueries,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 SearchSparkApplicationNativeSqlQueriesResponse) MarshalJSON() ([]byte, error) { + type NoMethod SearchSparkApplicationNativeSqlQueriesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SearchSparkApplicationSqlQueriesResponse: List of all queries for a Spark // Application. type SearchSparkApplicationSqlQueriesResponse struct { @@ -7029,6 +7239,7 @@ type SoftwareConfig struct { // (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-version-clusters#supported-dataproc-image-versions). // It cannot be activated on clusters created with supported Dataproc on // Compute Engine image versions. + // "DELTA" - Delta Lake. // "DOCKER" - Docker // "DRUID" - The Druid query engine. (alpha) // "FLINK" - Flink @@ -7036,6 +7247,7 @@ type SoftwareConfig struct { // "HIVE_WEBHCAT" - The Hive Web HCatalog (the REST service for accessing // HCatalog). // "HUDI" - Hudi. + // "ICEBERG" - Iceberg. // "JUPYTER" - The Jupyter Notebook. // "PIG" - The Pig component. // "PRESTO" - The Presto query engine. @@ -8920,10 +9132,14 @@ type UsageMetrics struct { // seconds) (see Dataproc Serverless pricing // (https://cloud.google.com/dataproc-serverless/pricing)). MilliDcuSeconds int64 `json:"milliDcuSeconds,omitempty,string"` + // MilliSlotSeconds: Optional. Slot usage in (milliSlot x seconds). + MilliSlotSeconds int64 `json:"milliSlotSeconds,omitempty,string"` // ShuffleStorageGbSeconds: Optional. Shuffle storage usage in (GB x seconds) // (see Dataproc Serverless pricing // (https://cloud.google.com/dataproc-serverless/pricing)). ShuffleStorageGbSeconds int64 `json:"shuffleStorageGbSeconds,omitempty,string"` + // UpdateTime: Optional. The timestamp of the usage metrics. + UpdateTime string `json:"updateTime,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorType") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8959,6 +9175,8 @@ type UsageSnapshot struct { // (DCUs) charged at premium tier (see Dataproc Serverless pricing // (https://cloud.google.com/dataproc-serverless/pricing)). MilliDcuPremium int64 `json:"milliDcuPremium,omitempty,string"` + // MilliSlot: Optional. Milli (one-thousandth) Slot usage of the workload. + MilliSlot int64 `json:"milliSlot,omitempty,string"` // ShuffleStorageGb: Optional. Shuffle Storage in gigabytes (GB). (see Dataproc // Serverless pricing (https://cloud.google.com/dataproc-serverless/pricing)) ShuffleStorageGb int64 `json:"shuffleStorageGb,omitempty,string"` @@ -11299,7 +11517,7 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessJobCall) Do(opts ...goog return ret, nil } -type ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall struct { +type ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -11308,29 +11526,20 @@ type ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall struct { header_ http.Header } -// AccessSqlPlan: Obtain Spark Plan Graph for a Spark Application SQL -// execution. Limits the number of clusters returned as part of the graph to -// 10000. +// AccessNativeBuildInfo: Obtain build data for Native Job // // - name: The fully qualified name of the batch to retrieve in the format // "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplic // ations/APPLICATION_ID". -func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessSqlPlan(name string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { - c := &ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessNativeBuildInfo(name string) *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall { + c := &ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// ExecutionId sets the optional parameter "executionId": Required. Execution -// ID -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) ExecutionId(executionId int64) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { - c.urlParams_.Set("executionId", fmt.Sprint(executionId)) - return c -} - // Parent sets the optional parameter "parent": Required. Parent (Batch) // resource reference. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall { c.urlParams_.Set("parent", parent) return c } @@ -11338,7 +11547,7 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Parent(pare // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11346,34 +11555,34 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Fields(s .. // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Header() http.Header { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessSqlPlan") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessNativeBuildInfo") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -11383,17 +11592,17 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlPlan", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessNativeBuildInfo", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.batches.sparkApplications.accessSqlPlan" call. +// Do executes the "dataproc.projects.locations.batches.sparkApplications.accessNativeBuildInfo" call. // Any non-2xx status code is an error. Response headers are in either -// *AccessSparkApplicationSqlSparkPlanGraphResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *AccessSparkApplicationNativeBuildInfoResponse.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Do(opts ...googleapi.CallOption) (*AccessSparkApplicationSqlSparkPlanGraphResponse, error) { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeBuildInfoCall) Do(opts ...googleapi.CallOption) (*AccessSparkApplicationNativeBuildInfoResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11412,7 +11621,7 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &AccessSparkApplicationSqlSparkPlanGraphResponse{ + ret := &AccessSparkApplicationNativeBuildInfoResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11423,11 +11632,11 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlPlan", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessNativeBuildInfo", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall struct { +type ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -11436,50 +11645,36 @@ type ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall struct { header_ http.Header } -// AccessSqlQuery: Obtain data corresponding to a particular SQL Query for a -// Spark Application. +// AccessNativeSqlQuery: Obtain data corresponding to a particular Native SQL +// Query for a Spark Application. // // - name: The fully qualified name of the batch to retrieve in the format // "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplic // ations/APPLICATION_ID". -func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessSqlQuery(name string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { - c := &ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessNativeSqlQuery(name string) *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall { + c := &ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Details sets the optional parameter "details": Lists/ hides details of Spark -// plan nodes. True is set to list and false to hide. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Details(details bool) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { - c.urlParams_.Set("details", fmt.Sprint(details)) - return c -} - // ExecutionId sets the optional parameter "executionId": Required. Execution // ID -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) ExecutionId(executionId int64) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) ExecutionId(executionId int64) *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall { c.urlParams_.Set("executionId", fmt.Sprint(executionId)) return c } // Parent sets the optional parameter "parent": Required. Parent (Batch) // resource reference. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall { c.urlParams_.Set("parent", parent) return c } -// PlanDescription sets the optional parameter "planDescription": Enables/ -// disables physical plan description on demand -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) PlanDescription(planDescription bool) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { - c.urlParams_.Set("planDescription", fmt.Sprint(planDescription)) - return c -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11487,34 +11682,34 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Fields(s . // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Header() http.Header { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessSqlQuery") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessNativeSqlQuery") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -11524,17 +11719,17 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) doRequest( googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlQuery", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessNativeSqlQuery", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.batches.sparkApplications.accessSqlQuery" call. +// Do executes the "dataproc.projects.locations.batches.sparkApplications.accessNativeSqlQuery" call. // Any non-2xx status code is an error. Response headers are in either -// *AccessSparkApplicationSqlQueryResponse.ServerResponse.Header or (if a +// *AccessSparkApplicationNativeSqlQueryResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Do(opts ...googleapi.CallOption) (*AccessSparkApplicationSqlQueryResponse, error) { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessNativeSqlQueryCall) Do(opts ...googleapi.CallOption) (*AccessSparkApplicationNativeSqlQueryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11553,7 +11748,7 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Do(opts .. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &AccessSparkApplicationSqlQueryResponse{ + ret := &AccessSparkApplicationNativeSqlQueryResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11564,11 +11759,11 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Do(opts .. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlQuery", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessNativeSqlQuery", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall struct { +type ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -11577,52 +11772,37 @@ type ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall struct { header_ http.Header } -// AccessStageAttempt: Obtain data corresponding to a spark stage attempt for a -// Spark Application. +// AccessSqlPlan: Obtain Spark Plan Graph for a Spark Application SQL +// execution. Limits the number of clusters returned as part of the graph to +// 10000. // // - name: The fully qualified name of the batch to retrieve in the format // "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplic // ations/APPLICATION_ID". -func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessStageAttempt(name string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { - c := &ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessSqlPlan(name string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { + c := &ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Parent sets the optional parameter "parent": Required. Parent (Batch) -// resource reference. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { - c.urlParams_.Set("parent", parent) - return c -} - -// StageAttemptId sets the optional parameter "stageAttemptId": Required. Stage -// Attempt ID -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) StageAttemptId(stageAttemptId int64) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { - c.urlParams_.Set("stageAttemptId", fmt.Sprint(stageAttemptId)) - return c -} - -// StageId sets the optional parameter "stageId": Required. Stage ID -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) StageId(stageId int64) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { - c.urlParams_.Set("stageId", fmt.Sprint(stageId)) +// ExecutionId sets the optional parameter "executionId": Required. Execution +// ID +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) ExecutionId(executionId int64) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { + c.urlParams_.Set("executionId", fmt.Sprint(executionId)) return c } -// SummaryMetricsMask sets the optional parameter "summaryMetricsMask": The -// list of summary metrics fields to include. Empty list will default to skip -// all summary metrics fields. Example, if the response should include -// TaskQuantileMetrics, the request should have task_quantile_metrics in -// summary_metrics_mask field -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) SummaryMetricsMask(summaryMetricsMask string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { - c.urlParams_.Set("summaryMetricsMask", summaryMetricsMask) +// Parent sets the optional parameter "parent": Required. Parent (Batch) +// resource reference. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { + c.urlParams_.Set("parent", parent) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11630,20 +11810,304 @@ func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Fields // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Header() http.Header { +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessSqlPlan") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlPlan", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataproc.projects.locations.batches.sparkApplications.accessSqlPlan" call. +// Any non-2xx status code is an error. Response headers are in either +// *AccessSparkApplicationSqlSparkPlanGraphResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlPlanCall) Do(opts ...googleapi.CallOption) (*AccessSparkApplicationSqlSparkPlanGraphResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &AccessSparkApplicationSqlSparkPlanGraphResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlPlan", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AccessSqlQuery: Obtain data corresponding to a particular SQL Query for a +// Spark Application. +// +// - name: The fully qualified name of the batch to retrieve in the format +// "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplic +// ations/APPLICATION_ID". +func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessSqlQuery(name string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c := &ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Details sets the optional parameter "details": Lists/ hides details of Spark +// plan nodes. True is set to list and false to hide. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Details(details bool) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.urlParams_.Set("details", fmt.Sprint(details)) + return c +} + +// ExecutionId sets the optional parameter "executionId": Required. Execution +// ID +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) ExecutionId(executionId int64) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.urlParams_.Set("executionId", fmt.Sprint(executionId)) + return c +} + +// Parent sets the optional parameter "parent": Required. Parent (Batch) +// resource reference. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.urlParams_.Set("parent", parent) + return c +} + +// PlanDescription sets the optional parameter "planDescription": Enables/ +// disables physical plan description on demand +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) PlanDescription(planDescription bool) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.urlParams_.Set("planDescription", fmt.Sprint(planDescription)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessSqlQuery") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlQuery", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataproc.projects.locations.batches.sparkApplications.accessSqlQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *AccessSparkApplicationSqlQueryResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessSqlQueryCall) Do(opts ...googleapi.CallOption) (*AccessSparkApplicationSqlQueryResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &AccessSparkApplicationSqlQueryResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.accessSqlQuery", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AccessStageAttempt: Obtain data corresponding to a spark stage attempt for a +// Spark Application. +// +// - name: The fully qualified name of the batch to retrieve in the format +// "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplic +// ations/APPLICATION_ID". +func (r *ProjectsLocationsBatchesSparkApplicationsService) AccessStageAttempt(name string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c := &ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Parent sets the optional parameter "parent": Required. Parent (Batch) +// resource reference. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.urlParams_.Set("parent", parent) + return c +} + +// StageAttemptId sets the optional parameter "stageAttemptId": Required. Stage +// Attempt ID +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) StageAttemptId(stageAttemptId int64) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.urlParams_.Set("stageAttemptId", fmt.Sprint(stageAttemptId)) + return c +} + +// StageId sets the optional parameter "stageId": Required. Stage ID +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) StageId(stageId int64) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.urlParams_.Set("stageId", fmt.Sprint(stageId)) + return c +} + +// SummaryMetricsMask sets the optional parameter "summaryMetricsMask": The +// list of summary metrics fields to include. Empty list will default to skip +// all summary metrics fields. Example, if the response should include +// TaskQuantileMetrics, the request should have task_quantile_metrics in +// summary_metrics_mask field +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) SummaryMetricsMask(summaryMetricsMask string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.urlParams_.Set("summaryMetricsMask", summaryMetricsMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsBatchesSparkApplicationsAccessStageAttemptCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } @@ -12420,7 +12884,164 @@ func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) PageToken(page // Parent sets the optional parameter "parent": Required. Parent (Batch) // resource reference. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { + c.urlParams_.Set("parent", parent) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:searchJobs") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.searchJobs", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataproc.projects.locations.batches.sparkApplications.searchJobs" call. +// Any non-2xx status code is an error. Response headers are in either +// *SearchSparkApplicationJobsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Do(opts ...googleapi.CallOption) (*SearchSparkApplicationJobsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SearchSparkApplicationJobsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.searchJobs", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Pages(ctx context.Context, f func(*SearchSparkApplicationJobsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// SearchNativeSqlQueries: Obtain data corresponding to Native SQL Queries for +// a Spark Application. +// +// - name: The fully qualified name of the batch to retrieve in the format +// "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/sparkApplic +// ations/APPLICATION_ID". +func (r *ProjectsLocationsBatchesSparkApplicationsService) SearchNativeSqlQueries(name string) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { + c := &ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of queries +// to return in each response. The service may return fewer than this. The +// default page size is 10; the maximum page size is 100. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) PageSize(pageSize int64) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from a previous SearchSparkApplicationNativeSqlQueries call. Provide this +// token to retrieve the subsequent page. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) PageToken(pageToken string) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Parent sets the optional parameter "parent": Required. Parent (Batch) +// resource reference. +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) Parent(parent string) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { c.urlParams_.Set("parent", parent) return c } @@ -12428,7 +13049,7 @@ func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Parent(parent // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) Fields(s ...googleapi.Field) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -12436,34 +13057,34 @@ func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Fields(s ...go // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) IfNoneMatch(entityTag string) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) Context(ctx context.Context) *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Header() http.Header { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:searchJobs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:searchNativeSqlQueries") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -12473,17 +13094,17 @@ func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.searchJobs", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.searchNativeSqlQueries", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.batches.sparkApplications.searchJobs" call. +// Do executes the "dataproc.projects.locations.batches.sparkApplications.searchNativeSqlQueries" call. // Any non-2xx status code is an error. Response headers are in either -// *SearchSparkApplicationJobsResponse.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *SearchSparkApplicationNativeSqlQueriesResponse.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Do(opts ...googleapi.CallOption) (*SearchSparkApplicationJobsResponse, error) { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) Do(opts ...googleapi.CallOption) (*SearchSparkApplicationNativeSqlQueriesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12502,7 +13123,7 @@ func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &SearchSparkApplicationJobsResponse{ + ret := &SearchSparkApplicationNativeSqlQueriesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -12513,14 +13134,14 @@ func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.searchJobs", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.batches.sparkApplications.searchNativeSqlQueries", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsBatchesSparkApplicationsSearchJobsCall) Pages(ctx context.Context, f func(*SearchSparkApplicationJobsResponse) error) error { +func (c *ProjectsLocationsBatchesSparkApplicationsSearchNativeSqlQueriesCall) Pages(ctx context.Context, f func(*SearchSparkApplicationNativeSqlQueriesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -15439,24 +16060,262 @@ func (c *ProjectsLocationsSessionsTerminateCall) Context(ctx context.Context) *P // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsSessionsTerminateCall) Header() http.Header { +func (c *ProjectsLocationsSessionsTerminateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSessionsTerminateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.terminatesessionrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:terminate") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.terminate", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataproc.projects.locations.sessions.terminate" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsSessionsTerminateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.terminate", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsSessionsSparkApplicationsAccessCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Access: Obtain high level information corresponding to a single Spark +// Application. +// +// - name: The fully qualified name of the session to retrieve in the format +// "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApp +// lications/APPLICATION_ID". +func (r *ProjectsLocationsSessionsSparkApplicationsService) Access(name string) *ProjectsLocationsSessionsSparkApplicationsAccessCall { + c := &ProjectsLocationsSessionsSparkApplicationsAccessCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Parent sets the optional parameter "parent": Required. Parent (Session) +// resource reference. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessCall { + c.urlParams_.Set("parent", parent) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:access") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.access", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataproc.projects.locations.sessions.sparkApplications.access" call. +// Any non-2xx status code is an error. Response headers are in either +// *AccessSessionSparkApplicationResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &AccessSessionSparkApplicationResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.access", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AccessEnvironmentInfo: Obtain environment details for a Spark Application +// +// - name: The fully qualified name of the session to retrieve in the format +// "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApp +// lications/APPLICATION_ID". +func (r *ProjectsLocationsSessionsSparkApplicationsService) AccessEnvironmentInfo(name string) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { + c := &ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Parent sets the optional parameter "parent": Required. Parent (Session) +// resource reference. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { + c.urlParams_.Set("parent", parent) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSessionsTerminateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.terminatesessionrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:terminate") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessEnvironmentInfo") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -15464,16 +16323,17 @@ func (c *ProjectsLocationsSessionsTerminateCall) doRequest(alt string) (*http.Re googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.terminate", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessEnvironmentInfo", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.sessions.terminate" call. +// Do executes the "dataproc.projects.locations.sessions.sparkApplications.accessEnvironmentInfo" call. // Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsSessionsTerminateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +// *AccessSessionSparkApplicationEnvironmentInfoResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationEnvironmentInfoResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -15492,7 +16352,7 @@ func (c *ProjectsLocationsSessionsTerminateCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Operation{ + ret := &AccessSessionSparkApplicationEnvironmentInfoResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -15503,11 +16363,11 @@ func (c *ProjectsLocationsSessionsTerminateCall) Do(opts ...googleapi.CallOption if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.terminate", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessEnvironmentInfo", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsSessionsSparkApplicationsAccessCall struct { +type ProjectsLocationsSessionsSparkApplicationsAccessJobCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -15516,21 +16376,27 @@ type ProjectsLocationsSessionsSparkApplicationsAccessCall struct { header_ http.Header } -// Access: Obtain high level information corresponding to a single Spark -// Application. +// AccessJob: Obtain data corresponding to a spark job for a Spark Application. // // - name: The fully qualified name of the session to retrieve in the format // "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApp // lications/APPLICATION_ID". -func (r *ProjectsLocationsSessionsSparkApplicationsService) Access(name string) *ProjectsLocationsSessionsSparkApplicationsAccessCall { - c := &ProjectsLocationsSessionsSparkApplicationsAccessCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsSessionsSparkApplicationsService) AccessJob(name string) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { + c := &ProjectsLocationsSessionsSparkApplicationsAccessJobCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// JobId sets the optional parameter "jobId": Required. Job ID to fetch data +// for. +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) JobId(jobId int64) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { + c.urlParams_.Set("jobId", fmt.Sprint(jobId)) + return c +} + // Parent sets the optional parameter "parent": Required. Parent (Session) // resource reference. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { c.urlParams_.Set("parent", parent) return c } @@ -15538,7 +16404,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Parent(parent str // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -15546,34 +16412,34 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Fields(s ...googl // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Header() http.Header { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:access") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessJob") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -15583,17 +16449,17 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) doRequest(alt str googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.access", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessJob", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.sessions.sparkApplications.access" call. +// Do executes the "dataproc.projects.locations.sessions.sparkApplications.accessJob" call. // Any non-2xx status code is an error. Response headers are in either -// *AccessSessionSparkApplicationResponse.ServerResponse.Header or (if a +// *AccessSessionSparkApplicationJobResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationResponse, error) { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationJobResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -15612,7 +16478,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Do(opts ...google if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &AccessSessionSparkApplicationResponse{ + ret := &AccessSessionSparkApplicationJobResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -15623,11 +16489,11 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessCall) Do(opts ...google if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.access", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessJob", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall struct { +type ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -15636,20 +16502,21 @@ type ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall struct header_ http.Header } -// AccessEnvironmentInfo: Obtain environment details for a Spark Application +// AccessNativeBuildInfo: Obtain data corresponding to Native Build Information +// for a Spark Application. // // - name: The fully qualified name of the session to retrieve in the format // "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApp // lications/APPLICATION_ID". -func (r *ProjectsLocationsSessionsSparkApplicationsService) AccessEnvironmentInfo(name string) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { - c := &ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsSessionsSparkApplicationsService) AccessNativeBuildInfo(name string) *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall { + c := &ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Parent sets the optional parameter "parent": Required. Parent (Session) // resource reference. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall { c.urlParams_.Set("parent", parent) return c } @@ -15657,7 +16524,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Pa // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -15665,34 +16532,34 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Fi // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Header() http.Header { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessEnvironmentInfo") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessNativeBuildInfo") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -15702,17 +16569,17 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) do googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessEnvironmentInfo", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessNativeBuildInfo", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.sessions.sparkApplications.accessEnvironmentInfo" call. +// Do executes the "dataproc.projects.locations.sessions.sparkApplications.accessNativeBuildInfo" call. // Any non-2xx status code is an error. Response headers are in either -// *AccessSessionSparkApplicationEnvironmentInfoResponse.ServerResponse.Header +// *AccessSessionSparkApplicationNativeBuildInfoResponse.ServerResponse.Header // or (if a response was returned at all) in error.(*googleapi.Error).Header. // Use googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationEnvironmentInfoResponse, error) { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeBuildInfoCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationNativeBuildInfoResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -15731,7 +16598,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Do if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &AccessSessionSparkApplicationEnvironmentInfoResponse{ + ret := &AccessSessionSparkApplicationNativeBuildInfoResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -15742,11 +16609,11 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessEnvironmentInfoCall) Do if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessEnvironmentInfo", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessNativeBuildInfo", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsSessionsSparkApplicationsAccessJobCall struct { +type ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -15755,27 +16622,28 @@ type ProjectsLocationsSessionsSparkApplicationsAccessJobCall struct { header_ http.Header } -// AccessJob: Obtain data corresponding to a spark job for a Spark Application. +// AccessNativeSqlQuery: Obtain data corresponding to a particular Native SQL +// Query for a Spark Application. // // - name: The fully qualified name of the session to retrieve in the format // "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApp // lications/APPLICATION_ID". -func (r *ProjectsLocationsSessionsSparkApplicationsService) AccessJob(name string) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { - c := &ProjectsLocationsSessionsSparkApplicationsAccessJobCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsSessionsSparkApplicationsService) AccessNativeSqlQuery(name string) *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall { + c := &ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// JobId sets the optional parameter "jobId": Required. Job ID to fetch data -// for. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) JobId(jobId int64) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { - c.urlParams_.Set("jobId", fmt.Sprint(jobId)) +// ExecutionId sets the optional parameter "executionId": Required. Execution +// ID +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) ExecutionId(executionId int64) *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall { + c.urlParams_.Set("executionId", fmt.Sprint(executionId)) return c } // Parent sets the optional parameter "parent": Required. Parent (Session) // resource reference. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall { c.urlParams_.Set("parent", parent) return c } @@ -15783,7 +16651,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Parent(parent // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -15791,34 +16659,34 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Fields(s ...go // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessJobCall { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Header() http.Header { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessJob") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:accessNativeSqlQuery") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -15828,17 +16696,17 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessJob", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessNativeSqlQuery", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataproc.projects.locations.sessions.sparkApplications.accessJob" call. +// Do executes the "dataproc.projects.locations.sessions.sparkApplications.accessNativeSqlQuery" call. // Any non-2xx status code is an error. Response headers are in either -// *AccessSessionSparkApplicationJobResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because +// *AccessSessionSparkApplicationNativeSqlQueryResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationJobResponse, error) { +func (c *ProjectsLocationsSessionsSparkApplicationsAccessNativeSqlQueryCall) Do(opts ...googleapi.CallOption) (*AccessSessionSparkApplicationNativeSqlQueryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -15857,7 +16725,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &AccessSessionSparkApplicationJobResponse{ + ret := &AccessSessionSparkApplicationNativeSqlQueryResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -15868,7 +16736,7 @@ func (c *ProjectsLocationsSessionsSparkApplicationsAccessJobCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessJob", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.accessNativeSqlQuery", "response", internallog.HTTPResponse(res, b)) return ret, nil } @@ -17113,6 +17981,163 @@ func (c *ProjectsLocationsSessionsSparkApplicationsSearchJobsCall) Pages(ctx con } } +type ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// SearchNativeSqlQueries: Obtain data corresponding to Native SQL Queries for +// a Spark Application. +// +// - name: The fully qualified name of the session to retrieve in the format +// "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/sparkApp +// lications/APPLICATION_ID". +func (r *ProjectsLocationsSessionsSparkApplicationsService) SearchNativeSqlQueries(name string) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c := &ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of queries +// to return in each response. The service may return fewer than this. The +// default page size is 10; the maximum page size is 100. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) PageSize(pageSize int64) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from a previous SearchSessionSparkApplicationSqlQueries call. Provide this +// token to retrieve the subsequent page. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) PageToken(pageToken string) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Parent sets the optional parameter "parent": Required. Parent (Session) +// resource reference. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) Parent(parent string) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c.urlParams_.Set("parent", parent) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) Fields(s ...googleapi.Field) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) IfNoneMatch(entityTag string) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) Context(ctx context.Context) *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:searchNativeSqlQueries") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.searchNativeSqlQueries", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataproc.projects.locations.sessions.sparkApplications.searchNativeSqlQueries" call. +// Any non-2xx status code is an error. Response headers are in either +// *SearchSessionSparkApplicationNativeSqlQueriesResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) Do(opts ...googleapi.CallOption) (*SearchSessionSparkApplicationNativeSqlQueriesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SearchSessionSparkApplicationNativeSqlQueriesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataproc.projects.locations.sessions.sparkApplications.searchNativeSqlQueries", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsSessionsSparkApplicationsSearchNativeSqlQueriesCall) Pages(ctx context.Context, f func(*SearchSessionSparkApplicationNativeSqlQueriesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type ProjectsLocationsSessionsSparkApplicationsSearchSqlQueriesCall struct { s *Service name string diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index c313c6a9bb..fbb8845030 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1250,7 +1250,7 @@ } } }, - "revision": "20250219", + "revision": "20250310", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AppendOnly": { @@ -2207,6 +2207,10 @@ "format": "int32", "type": "integer" }, + "secretManagerStoredPassword": { + "description": "Optional. A reference to a Secret Manager resource name storing the MySQL connection password. Mutually exclusive with the `password` field.", + "type": "string" + }, "sslConfig": { "$ref": "MysqlSslConfig", "description": "SSL configuration for the MySQL connection." @@ -2288,7 +2292,7 @@ "type": "boolean" }, "clientKey": { - "description": "Optional. Input only. PEM-encoded private key associated with the Client Certificate. If this field is used then the 'client_certificate' and the 'ca_certificate' fields are mandatory. Mutually exclusive with the `secret_manager_stored_client_key` field.", + "description": "Optional. Input only. PEM-encoded private key associated with the Client Certificate. If this field is used then the 'client_certificate' and the 'ca_certificate' fields are mandatory.", "type": "string" }, "clientKeySet": { @@ -2450,7 +2454,7 @@ "description": "Optional. SSL configuration for the Oracle connection." }, "password": { - "description": "Optional. Password for the Oracle ASM connection.", + "description": "Optional. Password for the Oracle ASM connection. Mutually exclusive with the `secret_manager_stored_password` field.", "type": "string" }, "port": { @@ -2458,6 +2462,10 @@ "format": "int32", "type": "integer" }, + "secretManagerStoredPassword": { + "description": "Optional. A reference to a Secret Manager resource name storing the Oracle ASM connection password. Mutually exclusive with the `password` field.", + "type": "string" + }, "username": { "description": "Required. Username for the Oracle ASM connection.", "type": "string" @@ -2778,6 +2786,10 @@ "format": "int32", "type": "integer" }, + "secretManagerStoredPassword": { + "description": "Optional. A reference to a Secret Manager resource name storing the PostgreSQL connection password. Mutually exclusive with the `password` field.", + "type": "string" + }, "sslConfig": { "$ref": "PostgresqlSslConfig", "description": "Optional. SSL configuration for the PostgreSQL connection. In case PostgresqlSslConfig is not set, the connection will use the default SSL mode, which is `prefer` (i.e. this mode will only use encryption if enabled from database side, otherwise will use unencrypted communication)" @@ -3141,7 +3153,7 @@ "type": "string" }, "clientKey": { - "description": "Optional. Input only. PEM-encoded private key associated with the client certificate. This value will be used during the SSL/TLS handshake, allowing the PostgreSQL server to authenticate the client's identity, i.e. identity of the Datastream. Mutually exclusive with the `secret_manager_stored_client_key` field.", + "description": "Optional. Input only. PEM-encoded private key associated with the client certificate. This value will be used during the SSL/TLS handshake, allowing the PostgreSQL server to authenticate the client's identity, i.e. identity of the Datastream.", "type": "string" } }, @@ -3357,6 +3369,10 @@ "format": "int32", "type": "integer" }, + "secretManagerStoredPassword": { + "description": "Optional. A reference to a Secret Manager resource name storing the SQLServer connection password. Mutually exclusive with the `password` field.", + "type": "string" + }, "username": { "description": "Required. Username for the SQLServer connection.", "type": "string" diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index 79a7aab09f..96a267d370 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -1329,6 +1329,10 @@ type MysqlProfile struct { Password string `json:"password,omitempty"` // Port: Port for the MySQL connection, default value is 3306. Port int64 `json:"port,omitempty"` + // SecretManagerStoredPassword: Optional. A reference to a Secret Manager + // resource name storing the MySQL connection password. Mutually exclusive with + // the `password` field. + SecretManagerStoredPassword string `json:"secretManagerStoredPassword,omitempty"` // SslConfig: SSL configuration for the MySQL connection. SslConfig *MysqlSslConfig `json:"sslConfig,omitempty"` // Username: Required. Username for the MySQL connection. @@ -1427,8 +1431,7 @@ type MysqlSslConfig struct { ClientCertificateSet bool `json:"clientCertificateSet,omitempty"` // ClientKey: Optional. Input only. PEM-encoded private key associated with the // Client Certificate. If this field is used then the 'client_certificate' and - // the 'ca_certificate' fields are mandatory. Mutually exclusive with the - // `secret_manager_stored_client_key` field. + // the 'ca_certificate' fields are mandatory. ClientKey string `json:"clientKey,omitempty"` // ClientKeySet: Output only. Indicates whether the client_key field is set. ClientKeySet bool `json:"clientKeySet,omitempty"` @@ -1609,10 +1612,15 @@ type OracleAsmConfig struct { Hostname string `json:"hostname,omitempty"` // OracleSslConfig: Optional. SSL configuration for the Oracle connection. OracleSslConfig *OracleSslConfig `json:"oracleSslConfig,omitempty"` - // Password: Optional. Password for the Oracle ASM connection. + // Password: Optional. Password for the Oracle ASM connection. Mutually + // exclusive with the `secret_manager_stored_password` field. Password string `json:"password,omitempty"` // Port: Required. Port for the Oracle ASM connection. Port int64 `json:"port,omitempty"` + // SecretManagerStoredPassword: Optional. A reference to a Secret Manager + // resource name storing the Oracle ASM connection password. Mutually exclusive + // with the `password` field. + SecretManagerStoredPassword string `json:"secretManagerStoredPassword,omitempty"` // Username: Required. Username for the Oracle ASM connection. Username string `json:"username,omitempty"` // ForceSendFields is a list of field names (e.g. "AsmService") to @@ -1971,6 +1979,10 @@ type PostgresqlProfile struct { Password string `json:"password,omitempty"` // Port: Port for the PostgreSQL connection, default value is 5432. Port int64 `json:"port,omitempty"` + // SecretManagerStoredPassword: Optional. A reference to a Secret Manager + // resource name storing the PostgreSQL connection password. Mutually exclusive + // with the `password` field. + SecretManagerStoredPassword string `json:"secretManagerStoredPassword,omitempty"` // SslConfig: Optional. SSL configuration for the PostgreSQL connection. In // case PostgresqlSslConfig is not set, the connection will use the default SSL // mode, which is `prefer` (i.e. this mode will only use encryption if enabled @@ -2437,8 +2449,7 @@ type ServerAndClientVerification struct { // ClientKey: Optional. Input only. PEM-encoded private key associated with the // client certificate. This value will be used during the SSL/TLS handshake, // allowing the PostgreSQL server to authenticate the client's identity, i.e. - // identity of the Datastream. Mutually exclusive with the - // `secret_manager_stored_client_key` field. + // identity of the Datastream. ClientKey string `json:"clientKey,omitempty"` // ForceSendFields is a list of field names (e.g. "CaCertificate") to // unconditionally include in API requests. By default, fields with empty or @@ -2720,6 +2731,10 @@ type SqlServerProfile struct { Password string `json:"password,omitempty"` // Port: Port for the SQLServer connection, default value is 1433. Port int64 `json:"port,omitempty"` + // SecretManagerStoredPassword: Optional. A reference to a Secret Manager + // resource name storing the SQLServer connection password. Mutually exclusive + // with the `password` field. + SecretManagerStoredPassword string `json:"secretManagerStoredPassword,omitempty"` // Username: Required. Username for the SQLServer connection. Username string `json:"username,omitempty"` // ForceSendFields is a list of field names (e.g. "Database") to diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index ff24f88b63..0f025a054c 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -5343,7 +5343,7 @@ } } }, - "revision": "20250310", + "revision": "20250313", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -7676,14 +7676,26 @@ "$ref": "GoogleCloudDialogflowCxV3beta1AgentUtterance", "description": "Optional. Action performed by the agent as a message." }, + "event": { + "$ref": "GoogleCloudDialogflowCxV3beta1Event", + "description": "Optional. The agent received an event from the customer or a system event is emitted." + }, "flowInvocation": { "$ref": "GoogleCloudDialogflowCxV3beta1FlowInvocation", "description": "Optional. Action performed on behalf of the agent by invoking a CX flow." }, + "flowTransition": { + "$ref": "GoogleCloudDialogflowCxV3beta1FlowTransition", + "description": "Optional. Action performed on behalf of the agent by transitioning to a target CX flow." + }, "playbookInvocation": { "$ref": "GoogleCloudDialogflowCxV3beta1PlaybookInvocation", "description": "Optional. Action performed on behalf of the agent by invoking a child playbook." }, + "playbookTransition": { + "$ref": "GoogleCloudDialogflowCxV3beta1PlaybookTransition", + "description": "Optional. Action performed on behalf of the agent by transitioning to a target playbook." + }, "toolUse": { "$ref": "GoogleCloudDialogflowCxV3beta1ToolUse", "description": "Optional. Action performed on behalf of the agent by calling a plugin tool." @@ -9507,6 +9519,17 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1Event": { + "description": "Event represents the event sent by the customer.", + "id": "GoogleCloudDialogflowCxV3beta1Event", + "properties": { + "event": { + "description": "Required. Name of the event.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1EventHandler": { "description": "An event handler specifies an event that can be handled during a session. When the specified event happens, the following actions are taken in order: * If there is a `trigger_fulfillment` associated with the event, it will be called. * If there is a `target_page` associated with the event, the session will transition into the specified page. * If there is a `target_flow` associated with the event, the session will transition into the specified flow.", "id": "GoogleCloudDialogflowCxV3beta1EventHandler", @@ -10341,6 +10364,22 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1FlowTransition": { + "description": "Stores metadata of the transition to a target CX flow. Flow transition actions exit the caller playbook and enter the child flow.", + "id": "GoogleCloudDialogflowCxV3beta1FlowTransition", + "properties": { + "displayName": { + "description": "Output only. The display name of the flow.", + "readOnly": true, + "type": "string" + }, + "flow": { + "description": "Required. The unique identifier of the flow. Format: `projects//locations//agents/`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1FlowValidationResult": { "description": "The response message for Flows.GetFlowValidationResult.", "id": "GoogleCloudDialogflowCxV3beta1FlowValidationResult", @@ -12347,6 +12386,20 @@ }, "type": "array" }, + "playbookType": { + "description": "Optional. Type of the playbook.", + "enum": [ + "PLAYBOOK_TYPE_UNSPECIFIED", + "TASK", + "ROUTINE" + ], + "enumDescriptions": [ + "Unspecified type. Default to TASK.", + "Task playbook.", + "Routine playbook." + ], + "type": "string" + }, "referencedFlows": { "description": "Output only. The resource name of flows referenced by the current playbook in the instructions.", "items": { @@ -12507,6 +12560,22 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1PlaybookTransition": { + "description": "Stores metadata of the transition to another target playbook. Playbook transition actions exit the caller playbook and enter the target playbook.", + "id": "GoogleCloudDialogflowCxV3beta1PlaybookTransition", + "properties": { + "displayName": { + "description": "Output only. The display name of the playbook.", + "readOnly": true, + "type": "string" + }, + "playbook": { + "description": "Required. The unique identifier of the playbook. Format: `projects//locations//agents//playbooks/`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1PlaybookVersion": { "description": "Playbook version is a snapshot of the playbook at certain timestamp.", "id": "GoogleCloudDialogflowCxV3beta1PlaybookVersion", diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index d377447dd5..10aaf23143 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -3846,12 +3846,21 @@ func (s GoogleCloudDialogflowCxV3WebhookServiceDirectoryConfig) MarshalJSON() ([ type GoogleCloudDialogflowCxV3beta1Action struct { // AgentUtterance: Optional. Action performed by the agent as a message. AgentUtterance *GoogleCloudDialogflowCxV3beta1AgentUtterance `json:"agentUtterance,omitempty"` + // Event: Optional. The agent received an event from the customer or a system + // event is emitted. + Event *GoogleCloudDialogflowCxV3beta1Event `json:"event,omitempty"` // FlowInvocation: Optional. Action performed on behalf of the agent by // invoking a CX flow. FlowInvocation *GoogleCloudDialogflowCxV3beta1FlowInvocation `json:"flowInvocation,omitempty"` + // FlowTransition: Optional. Action performed on behalf of the agent by + // transitioning to a target CX flow. + FlowTransition *GoogleCloudDialogflowCxV3beta1FlowTransition `json:"flowTransition,omitempty"` // PlaybookInvocation: Optional. Action performed on behalf of the agent by // invoking a child playbook. PlaybookInvocation *GoogleCloudDialogflowCxV3beta1PlaybookInvocation `json:"playbookInvocation,omitempty"` + // PlaybookTransition: Optional. Action performed on behalf of the agent by + // transitioning to a target playbook. + PlaybookTransition *GoogleCloudDialogflowCxV3beta1PlaybookTransition `json:"playbookTransition,omitempty"` // ToolUse: Optional. Action performed on behalf of the agent by calling a // plugin tool. ToolUse *GoogleCloudDialogflowCxV3beta1ToolUse `json:"toolUse,omitempty"` @@ -6337,6 +6346,29 @@ func (s GoogleCloudDialogflowCxV3beta1EnvironmentWebhookConfig) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1Event: Event represents the event sent by the +// customer. +type GoogleCloudDialogflowCxV3beta1Event struct { + // Event: Required. Name of the event. + Event string `json:"event,omitempty"` + // ForceSendFields is a list of field names (e.g. "Event") 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. "Event") 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 GoogleCloudDialogflowCxV3beta1Event) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1Event + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1EventHandler: An event handler specifies an // event that can be handled during a session. When the specified event // happens, the following actions are taken in order: * If there is a @@ -7404,6 +7436,33 @@ func (s GoogleCloudDialogflowCxV3beta1FlowMultiLanguageSettings) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1FlowTransition: Stores metadata of the +// transition to a target CX flow. Flow transition actions exit the caller +// playbook and enter the child flow. +type GoogleCloudDialogflowCxV3beta1FlowTransition struct { + // DisplayName: Output only. The display name of the flow. + DisplayName string `json:"displayName,omitempty"` + // Flow: Required. The unique identifier of the flow. Format: + // `projects//locations//agents/`. + Flow string `json:"flow,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 GoogleCloudDialogflowCxV3beta1FlowTransition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1FlowTransition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1FlowValidationResult: The response message for // Flows.GetFlowValidationResult. type GoogleCloudDialogflowCxV3beta1FlowValidationResult struct { @@ -10424,6 +10483,13 @@ type GoogleCloudDialogflowCxV3beta1Playbook struct { // OutputParameterDefinitions: Optional. Defined structured output parameters // for this playbook. OutputParameterDefinitions []*GoogleCloudDialogflowCxV3beta1ParameterDefinition `json:"outputParameterDefinitions,omitempty"` + // PlaybookType: Optional. Type of the playbook. + // + // Possible values: + // "PLAYBOOK_TYPE_UNSPECIFIED" - Unspecified type. Default to TASK. + // "TASK" - Task playbook. + // "ROUTINE" - Routine playbook. + PlaybookType string `json:"playbookType,omitempty"` // ReferencedFlows: Output only. The resource name of flows referenced by the // current playbook in the instructions. ReferencedFlows []string `json:"referencedFlows,omitempty"` @@ -10608,6 +10674,33 @@ func (s GoogleCloudDialogflowCxV3beta1PlaybookStep) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1PlaybookTransition: Stores metadata of the +// transition to another target playbook. Playbook transition actions exit the +// caller playbook and enter the target playbook. +type GoogleCloudDialogflowCxV3beta1PlaybookTransition struct { + // DisplayName: Output only. The display name of the playbook. + DisplayName string `json:"displayName,omitempty"` + // Playbook: Required. The unique identifier of the playbook. Format: + // `projects//locations//agents//playbooks/`. + Playbook string `json:"playbook,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 GoogleCloudDialogflowCxV3beta1PlaybookTransition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1PlaybookTransition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1PlaybookVersion: Playbook version is a // snapshot of the playbook at certain timestamp. type GoogleCloudDialogflowCxV3beta1PlaybookVersion struct { diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index eaae5d93d1..53bd233355 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -6499,6 +6499,39 @@ } } }, + "podcasts": { + "resources": { + "operations": { + "methods": { + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/podcasts/{podcastsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.podcasts.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/podcasts/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "rankingConfigs": { "methods": { "rank": { @@ -6740,7 +6773,7 @@ } } }, - "revision": "20250306", + "revision": "20250314", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -7597,6 +7630,10 @@ "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec", "properties": { + "disableSpellCorrection": { + "description": "Optional. Whether to disable spell correction. The default value is `false`.", + "type": "boolean" + }, "queryClassificationSpec": { "$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec", "description": "Query classification specification." @@ -8916,6 +8953,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -12127,7 +12181,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -12160,6 +12214,10 @@ }, "type": "array" }, + "displaySpec": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec", + "description": "Optional. Config for display feature, like match highlighting on search results." + }, "facetSpecs": { "description": "Facet specifications for faceted search. If empty, no facets are returned. A maximum of 100 values are allowed. Otherwise, an `INVALID_ARGUMENT` error is returned.", "items": { @@ -12567,6 +12625,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec": { + "description": "Specifies features for display, like match highlighting.", + "id": "GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec", + "properties": { + "matchHighlightingCondition": { + "description": "The condition under which match highlighting should occur.", + "enum": [ + "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED", + "MATCH_HIGHLIGHTING_DISABLED", + "MATCH_HIGHLIGHTING_ENABLED" + ], + "enumDescriptions": [ + "Server behavior is the same as `MATCH_HIGHLIGHTING_DISABLED`.", + "Disables match highlighting on all documents.", + "Enables match highlighting on all documents." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1SearchRequestFacetSpec": { "description": "A facet specification to perform faceted search.", "id": "GoogleCloudDiscoveryengineV1SearchRequestFacetSpec", @@ -13985,6 +14064,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig": { + "description": "The connector level alert config.", + "id": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig", + "properties": { + "alertEnrollments": { + "description": "Optional. The enrollment states of each alert.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment" + }, + "type": "array" + }, + "alertPolicyName": { + "description": "Immutable. The fully qualified resource name of the AlertPolicy.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment": { + "description": "The alert enrollment status.", + "id": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment", + "properties": { + "alertId": { + "description": "Immutable. The id of an alert.", + "type": "string" + }, + "enrollState": { + "description": "Required. The enrollment status of a customer.", + "enum": [ + "ENROLL_STATES_UNSPECIFIED", + "ENROLLED", + "DECLINED" + ], + "enumDescriptions": [ + "Default value. Used for customers who have not responded to the alert policy.", + "Customer is enrolled in this policy.", + "Customer declined this policy." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswer": { "description": "Defines an answer.", "id": "GoogleCloudDiscoveryengineV1alphaAnswer", @@ -14024,6 +14146,13 @@ "description": "The textual answer.", "type": "string" }, + "blobAttachments": { + "description": "List of blob attachments in the answer.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment" + }, + "type": "array" + }, "citations": { "description": "Citations.", "items": { @@ -14112,6 +14241,51 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment": { + "description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment", + "properties": { + "attributionType": { + "description": "Output only. The attribution type of the blob.", + "enum": [ + "ATTRIBUTION_TYPE_UNSPECIFIED", + "CORPUS", + "GENERATED" + ], + "enumDescriptions": [ + "Unspecified attribution type.", + "The attachment data is from the corpus.", + "The attachment data is generated by the model through code generation." + ], + "readOnly": true, + "type": "string" + }, + "data": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob", + "description": "Output only. The mime type and data of the blob.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob": { + "description": "The media type and data of the blob.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob", + "properties": { + "data": { + "description": "Output only. Raw bytes.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "mimeType": { + "description": "Output only. The media type (MIME type) of the generated or retrieved data.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswerCitation": { "description": "Citation info for a segment.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerCitation", @@ -14246,6 +14420,15 @@ "description": "Chunk information.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "chunk": { "description": "Chunk resource name.", "type": "string" @@ -14364,6 +14547,15 @@ "description": "Chunk content.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "content": { "description": "Chunk textual content.", "type": "string" @@ -14615,6 +14807,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -14785,7 +14994,8 @@ "OVERRUN", "CANCELLED", "PENDING", - "WARNING" + "WARNING", + "SKIPPED" ], "enumDescriptions": [ "Default value.", @@ -14795,7 +15005,8 @@ "Data sync has been running longer than expected and is still running at the time the next run is supposed to start.", "Data sync was scheduled but has been cancelled.", "Data sync is about to start.", - "The data sync completed with non-fatal errors." + "The data sync completed with non-fatal errors.", + "An ongoing connector run has been running longer than expected, causing this run to be skipped." ], "readOnly": true, "type": "string" @@ -14881,7 +15092,8 @@ "OVERRUN", "CANCELLED", "PENDING", - "WARNING" + "WARNING", + "SKIPPED" ], "enumDescriptions": [ "Default value.", @@ -14891,7 +15103,8 @@ "Data sync has been running longer than expected and is still running at the time the next run is supposed to start.", "Data sync was scheduled but has been cancelled.", "Data sync is about to start.", - "The data sync completed with non-fatal errors." + "The data sync completed with non-fatal errors.", + "An ongoing connector run has been running longer than expected, causing this run to be skipped." ], "type": "string" }, @@ -15297,6 +15510,13 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaActionConfig", "description": "Optional. Action configurations to make the connector support actions." }, + "alertPolicyConfigs": { + "description": "Optional. The connector level alert config.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig" + }, + "type": "array" + }, "autoRunDisabled": { "description": "Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync.", "type": "boolean" @@ -17874,7 +18094,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -18307,6 +18527,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec", "description": "If specified, the spec will be used to modify the model specification provided to the LLM." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "description": "Optional. Multimodal specification." + }, "summaryResultCount": { "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.", "format": "int32", @@ -18341,6 +18565,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec": { "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec", @@ -19238,6 +19485,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -21131,7 +21395,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -21164,6 +21428,10 @@ }, "type": "array" }, + "displaySpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec", + "description": "Optional. Config for display feature, like match highlighting on search results." + }, "embeddingSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec", "description": "Uses the provided embedding to do additional semantic document retrieval. The retrieval is based on the dot product of SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document embedding that is provided in SearchRequest.EmbeddingSpec.EmbeddingVector.field_path. If SearchRequest.EmbeddingSpec.EmbeddingVector.field_path is not provided, it will use ServingConfig.EmbeddingConfig.field_path." @@ -21556,6 +21824,10 @@ "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec", "description": "If specified, the spec will be used to modify the model specification provided to the LLM." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "description": "Optional. Multimodal specification." + }, "summaryResultCount": { "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.", "format": "int32", @@ -21590,6 +21862,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec": { "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec", @@ -21609,6 +21904,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec": { + "description": "Specifies features for display, like match highlighting.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec", + "properties": { + "matchHighlightingCondition": { + "description": "The condition under which match highlighting should occur.", + "enum": [ + "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED", + "MATCH_HIGHLIGHTING_DISABLED", + "MATCH_HIGHLIGHTING_ENABLED" + ], + "enumDescriptions": [ + "Server behavior is the same as `MATCH_HIGHLIGHTING_DISABLED`.", + "Disables match highlighting on all documents.", + "Enables match highlighting on all documents." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec": { "description": "The specification that uses customized query embedding vector to do semantic document retrieval.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec", diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index dc59c17734..386addf168 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -179,6 +179,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.GroundingConfigs = NewProjectsLocationsGroundingConfigsService(s) rs.IdentityMappingStores = NewProjectsLocationsIdentityMappingStoresService(s) rs.Operations = NewProjectsLocationsOperationsService(s) + rs.Podcasts = NewProjectsLocationsPodcastsService(s) rs.RankingConfigs = NewProjectsLocationsRankingConfigsService(s) rs.UserEvents = NewProjectsLocationsUserEventsService(s) return rs @@ -197,6 +198,8 @@ type ProjectsLocationsService struct { Operations *ProjectsLocationsOperationsService + Podcasts *ProjectsLocationsPodcastsService + RankingConfigs *ProjectsLocationsRankingConfigsService UserEvents *ProjectsLocationsUserEventsService @@ -871,6 +874,27 @@ type ProjectsLocationsOperationsService struct { s *Service } +func NewProjectsLocationsPodcastsService(s *Service) *ProjectsLocationsPodcastsService { + rs := &ProjectsLocationsPodcastsService{s: s} + rs.Operations = NewProjectsLocationsPodcastsOperationsService(s) + return rs +} + +type ProjectsLocationsPodcastsService struct { + s *Service + + Operations *ProjectsLocationsPodcastsOperationsService +} + +func NewProjectsLocationsPodcastsOperationsService(s *Service) *ProjectsLocationsPodcastsOperationsService { + rs := &ProjectsLocationsPodcastsOperationsService{s: s} + return rs +} + +type ProjectsLocationsPodcastsOperationsService struct { + s *Service +} + func NewProjectsLocationsRankingConfigsService(s *Service) *ProjectsLocationsRankingConfigsService { rs := &ProjectsLocationsRankingConfigsService{s: s} return rs @@ -2209,17 +2233,20 @@ func (s GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec) MarshalJSON // GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec: Query // understanding specification. type GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec struct { + // DisableSpellCorrection: Optional. Whether to disable spell correction. The + // default value is `false`. + DisableSpellCorrection bool `json:"disableSpellCorrection,omitempty"` // QueryClassificationSpec: Query classification specification. QueryClassificationSpec *GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec `json:"queryClassificationSpec,omitempty"` // QueryRephraserSpec: Query rephraser specification. QueryRephraserSpec *GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpec `json:"queryRephraserSpec,omitempty"` - // ForceSendFields is a list of field names (e.g. "QueryClassificationSpec") to + // ForceSendFields is a list of field names (e.g. "DisableSpellCorrection") 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. "QueryClassificationSpec") to + // NullFields is a list of field names (e.g. "DisableSpellCorrection") 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. @@ -4029,6 +4056,15 @@ type GoogleCloudDiscoveryengineV1CmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1SingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -8663,7 +8699,8 @@ type GoogleCloudDiscoveryengineV1SearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -8712,6 +8749,9 @@ type GoogleCloudDiscoveryengineV1SearchRequest struct { // considered for Engines with multiple data stores. For engines with a single // data store, the specs directly under SearchRequest should be used. DataStoreSpecs []*GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec `json:"dataStoreSpecs,omitempty"` + // DisplaySpec: Optional. Config for display feature, like match highlighting + // on search results. + DisplaySpec *GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec `json:"displaySpec,omitempty"` // FacetSpecs: Facet specifications for faceted search. If empty, no facets are // returned. A maximum of 100 values are allowed. Otherwise, an // `INVALID_ARGUMENT` error is returned. @@ -9396,6 +9436,38 @@ func (s GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec: Specifies features for +// display, like match highlighting. +type GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec struct { + // MatchHighlightingCondition: The condition under which match highlighting + // should occur. + // + // Possible values: + // "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED" - Server behavior is the same + // as `MATCH_HIGHLIGHTING_DISABLED`. + // "MATCH_HIGHLIGHTING_DISABLED" - Disables match highlighting on all + // documents. + // "MATCH_HIGHLIGHTING_ENABLED" - Enables match highlighting on all + // documents. + MatchHighlightingCondition string `json:"matchHighlightingCondition,omitempty"` + // ForceSendFields is a list of field names (e.g. "MatchHighlightingCondition") + // 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. "MatchHighlightingCondition") 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 GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1SearchRequestFacetSpec: A facet specification to // perform faceted search. type GoogleCloudDiscoveryengineV1SearchRequestFacetSpec struct { @@ -11419,6 +11491,63 @@ func (s GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig: The connector level +// alert config. +type GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig struct { + // AlertEnrollments: Optional. The enrollment states of each alert. + AlertEnrollments []*GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment `json:"alertEnrollments,omitempty"` + // AlertPolicyName: Immutable. The fully qualified resource name of the + // AlertPolicy. + AlertPolicyName string `json:"alertPolicyName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertEnrollments") 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. "AlertEnrollments") 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 GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment: The alert +// enrollment status. +type GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment struct { + // AlertId: Immutable. The id of an alert. + AlertId string `json:"alertId,omitempty"` + // EnrollState: Required. The enrollment status of a customer. + // + // Possible values: + // "ENROLL_STATES_UNSPECIFIED" - Default value. Used for customers who have + // not responded to the alert policy. + // "ENROLLED" - Customer is enrolled in this policy. + // "DECLINED" - Customer declined this policy. + EnrollState string `json:"enrollState,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertId") 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. "AlertId") 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 GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswer: Defines an answer. type GoogleCloudDiscoveryengineV1alphaAnswer struct { // AnswerSkippedReasons: Additional answer-skipped reasons. This provides the @@ -11451,6 +11580,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` + // BlobAttachments: List of blob attachments in the answer. + BlobAttachments []*GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment `json:"blobAttachments,omitempty"` // Citations: Citations. Citations []*GoogleCloudDiscoveryengineV1alphaAnswerCitation `json:"citations,omitempty"` // CompleteTime: Output only. Answer completed timestamp. @@ -11517,6 +11648,63 @@ func (s *GoogleCloudDiscoveryengineV1alphaAnswer) UnmarshalJSON(data []byte) err return nil } +// GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment: Stores binarydata +// attached to text answer, e.g. image, video, audio, etc. +type GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment struct { + // AttributionType: Output only. The attribution type of the blob. + // + // Possible values: + // "ATTRIBUTION_TYPE_UNSPECIFIED" - Unspecified attribution type. + // "CORPUS" - The attachment data is from the corpus. + // "GENERATED" - The attachment data is generated by the model through code + // generation. + AttributionType string `json:"attributionType,omitempty"` + // Data: Output only. The mime type and data of the blob. + Data *GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributionType") 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. "AttributionType") 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 GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob: The media type +// and data of the blob. +type GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob struct { + // Data: Output only. Raw bytes. + Data string `json:"data,omitempty"` + // MimeType: Output only. The media type (MIME type) of the generated or + // retrieved data. + MimeType string `json:"mimeType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswerCitation: Citation info for a // segment. type GoogleCloudDiscoveryengineV1alphaAnswerCitation struct { @@ -11707,6 +11895,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerReference) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo: Chunk // information. type GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Chunk: Chunk resource name. Chunk string `json:"chunk,omitempty"` // Content: Chunk textual content. @@ -11718,15 +11909,15 @@ type GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo struct { // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Chunk") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Chunk") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -11846,6 +12037,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfo // GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunk // Content: Chunk content. type GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Content: Chunk textual content. Content string `json:"content,omitempty"` // PageIdentifier: Page identifier. @@ -11855,15 +12049,15 @@ type GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChu // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Content") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Content") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -12194,6 +12388,15 @@ type GoogleCloudDiscoveryengineV1alphaCmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1alphaSingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -12388,6 +12591,8 @@ type GoogleCloudDiscoveryengineV1alphaConnectorRun struct { // "CANCELLED" - Data sync was scheduled but has been cancelled. // "PENDING" - Data sync is about to start. // "WARNING" - The data sync completed with non-fatal errors. + // "SKIPPED" - An ongoing connector run has been running longer than + // expected, causing this run to be skipped. State string `json:"state,omitempty"` // StateUpdateTime: Timestamp at which the connector run sync state was last // updated. @@ -12455,6 +12660,8 @@ type GoogleCloudDiscoveryengineV1alphaConnectorRunEntityRun struct { // "CANCELLED" - Data sync was scheduled but has been cancelled. // "PENDING" - Data sync is about to start. // "WARNING" - The data sync completed with non-fatal errors. + // "SKIPPED" - An ongoing connector run has been running longer than + // expected, causing this run to be skipped. State string `json:"state,omitempty"` // StateUpdateTime: Timestamp at which the entity sync state was last updated. StateUpdateTime string `json:"stateUpdateTime,omitempty"` @@ -13064,6 +13271,8 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // ActionConfig: Optional. Action configurations to make the connector support // actions. ActionConfig *GoogleCloudDiscoveryengineV1alphaActionConfig `json:"actionConfig,omitempty"` + // AlertPolicyConfigs: Optional. The connector level alert config. + AlertPolicyConfigs []*GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig `json:"alertPolicyConfigs,omitempty"` // AutoRunDisabled: Indicates whether the connector is disabled for auto run. // It can be used to pause periodical and real time sync. AutoRunDisabled bool `json:"autoRunDisabled,omitempty"` @@ -16355,7 +16564,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -17045,6 +17255,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpec // ModelSpec: If specified, the spec will be used to modify the model // specification provided to the LLM. ModelSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec `json:"multimodalSpec,omitempty"` // SummaryResultCount: The number of top results to generate the summary from. // If the number of results returned is less than `summaryResultCount`, the // summary is generated from all of the results. At most 10 results for @@ -17130,6 +17342,39 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySp return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMul +// tiModalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec: A struct to // define data stores to filter on in a search call and configurations for // those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned. @@ -18428,6 +18673,15 @@ type GoogleCloudDiscoveryengineV1betaCmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1betaSingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -21014,7 +21268,8 @@ type GoogleCloudDiscoveryengineV1betaSearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -21063,6 +21318,9 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // considered for Engines with multiple data stores. For engines with a single // data store, the specs directly under SearchRequest should be used. DataStoreSpecs []*GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec `json:"dataStoreSpecs,omitempty"` + // DisplaySpec: Optional. Config for display feature, like match highlighting + // on search results. + DisplaySpec *GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec `json:"displaySpec,omitempty"` // EmbeddingSpec: Uses the provided embedding to do additional semantic // document retrieval. The retrieval is based on the dot product of // SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document @@ -21698,6 +21956,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec s // ModelSpec: If specified, the spec will be used to modify the model // specification provided to the LLM. ModelSpec *GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec `json:"multimodalSpec,omitempty"` // SummaryResultCount: The number of top results to generate the summary from. // If the number of results returned is less than `summaryResultCount`, the // summary is generated from all of the results. At most 10 results for @@ -21783,6 +22043,39 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpe return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMult +// iModalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec: A struct to // define data stores to filter on in a search call and configurations for // those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned. @@ -21818,6 +22111,38 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec) MarshalJSON( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec: Specifies features +// for display, like match highlighting. +type GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec struct { + // MatchHighlightingCondition: The condition under which match highlighting + // should occur. + // + // Possible values: + // "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED" - Server behavior is the same + // as `MATCH_HIGHLIGHTING_DISABLED`. + // "MATCH_HIGHLIGHTING_DISABLED" - Disables match highlighting on all + // documents. + // "MATCH_HIGHLIGHTING_ENABLED" - Enables match highlighting on all + // documents. + MatchHighlightingCondition string `json:"matchHighlightingCondition,omitempty"` + // ForceSendFields is a list of field names (e.g. "MatchHighlightingCondition") + // 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. "MatchHighlightingCondition") 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 GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec: The // specification that uses customized query embedding vector to do semantic // document retrieval. @@ -46977,6 +47302,118 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } +type ProjectsLocationsPodcastsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsPodcastsOperationsService) Get(name string) *ProjectsLocationsPodcastsOperationsGetCall { + c := &ProjectsLocationsPodcastsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsPodcastsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsPodcastsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsPodcastsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsPodcastsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPodcastsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.podcasts.operations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.podcasts.operations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.podcasts.operations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsRankingConfigsRankCall struct { s *Service rankingConfig string diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 24dd4e7691..70fece888a 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -8291,6 +8291,39 @@ } } }, + "podcasts": { + "resources": { + "operations": { + "methods": { + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/podcasts/{podcastsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.podcasts.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/podcasts/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "rankingConfigs": { "methods": { "rank": { @@ -8983,7 +9016,7 @@ } } }, - "revision": "20250306", + "revision": "20250314", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "ApiservingMediaRequestInfo": { @@ -10054,6 +10087,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -11591,7 +11641,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -12609,6 +12659,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig": { + "description": "The connector level alert config.", + "id": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig", + "properties": { + "alertEnrollments": { + "description": "Optional. The enrollment states of each alert.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment" + }, + "type": "array" + }, + "alertPolicyName": { + "description": "Immutable. The fully qualified resource name of the AlertPolicy.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment": { + "description": "The alert enrollment status.", + "id": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment", + "properties": { + "alertId": { + "description": "Immutable. The id of an alert.", + "type": "string" + }, + "enrollState": { + "description": "Required. The enrollment status of a customer.", + "enum": [ + "ENROLL_STATES_UNSPECIFIED", + "ENROLLED", + "DECLINED" + ], + "enumDescriptions": [ + "Default value. Used for customers who have not responded to the alert policy.", + "Customer is enrolled in this policy.", + "Customer declined this policy." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAlloyDbSource": { "description": "AlloyDB source import data from.", "id": "GoogleCloudDiscoveryengineV1alphaAlloyDbSource", @@ -12679,6 +12772,13 @@ "description": "The textual answer.", "type": "string" }, + "blobAttachments": { + "description": "List of blob attachments in the answer.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment" + }, + "type": "array" + }, "citations": { "description": "Citations.", "items": { @@ -12767,6 +12867,51 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment": { + "description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment", + "properties": { + "attributionType": { + "description": "Output only. The attribution type of the blob.", + "enum": [ + "ATTRIBUTION_TYPE_UNSPECIFIED", + "CORPUS", + "GENERATED" + ], + "enumDescriptions": [ + "Unspecified attribution type.", + "The attachment data is from the corpus.", + "The attachment data is generated by the model through code generation." + ], + "readOnly": true, + "type": "string" + }, + "data": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob", + "description": "Output only. The mime type and data of the blob.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob": { + "description": "The media type and data of the blob.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob", + "properties": { + "data": { + "description": "Output only. Raw bytes.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "mimeType": { + "description": "Output only. The media type (MIME type) of the generated or retrieved data.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswerCitation": { "description": "Citation info for a segment.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerCitation", @@ -12926,6 +13071,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecModelSpec", "description": "Answer generation model specification." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec", + "description": "Optional. Multimodal specification." + }, "promptSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec", "description": "Answer generation prompt specification." @@ -12944,6 +13093,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec": { "description": "Answer generation prompt specification.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec", @@ -13035,6 +13207,10 @@ "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec", "properties": { + "disableSpellCorrection": { + "description": "Optional. Whether to disable spell correction. The default value is `false`.", + "type": "boolean" + }, "queryClassificationSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec", "description": "Query classification specification." @@ -13493,6 +13669,15 @@ "description": "Chunk information.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "chunk": { "description": "Chunk resource name.", "type": "string" @@ -13611,6 +13796,15 @@ "description": "Chunk content.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "content": { "description": "Chunk textual content.", "type": "string" @@ -14463,6 +14657,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -14726,7 +14937,8 @@ "OVERRUN", "CANCELLED", "PENDING", - "WARNING" + "WARNING", + "SKIPPED" ], "enumDescriptions": [ "Default value.", @@ -14736,7 +14948,8 @@ "Data sync has been running longer than expected and is still running at the time the next run is supposed to start.", "Data sync was scheduled but has been cancelled.", "Data sync is about to start.", - "The data sync completed with non-fatal errors." + "The data sync completed with non-fatal errors.", + "An ongoing connector run has been running longer than expected, causing this run to be skipped." ], "readOnly": true, "type": "string" @@ -14822,7 +15035,8 @@ "OVERRUN", "CANCELLED", "PENDING", - "WARNING" + "WARNING", + "SKIPPED" ], "enumDescriptions": [ "Default value.", @@ -14832,7 +15046,8 @@ "Data sync has been running longer than expected and is still running at the time the next run is supposed to start.", "Data sync was scheduled but has been cancelled.", "Data sync is about to start.", - "The data sync completed with non-fatal errors." + "The data sync completed with non-fatal errors.", + "An ongoing connector run has been running longer than expected, causing this run to be skipped." ], "type": "string" }, @@ -15500,6 +15715,13 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaActionConfig", "description": "Optional. Action configurations to make the connector support actions." }, + "alertPolicyConfigs": { + "description": "Optional. The connector level alert config.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig" + }, + "type": "array" + }, "autoRunDisabled": { "description": "Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync.", "type": "boolean" @@ -19994,7 +20216,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -20427,6 +20649,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec", "description": "If specified, the spec will be used to modify the model specification provided to the LLM." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "description": "Optional. Multimodal specification." + }, "summaryResultCount": { "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.", "format": "int32", @@ -20461,6 +20687,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec": { "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec", @@ -21291,6 +21540,51 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment": { + "description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment", + "properties": { + "attributionType": { + "description": "Output only. The attribution type of the blob.", + "enum": [ + "ATTRIBUTION_TYPE_UNSPECIFIED", + "CORPUS", + "GENERATED" + ], + "enumDescriptions": [ + "Unspecified attribution type.", + "The attachment data is from the corpus.", + "The attachment data is generated by the model through code generation." + ], + "readOnly": true, + "type": "string" + }, + "data": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob", + "description": "Output only. The blob data.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob": { + "description": "Stores type and data of the blob.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob", + "properties": { + "data": { + "description": "Output only. Raw bytes.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "mimeType": { + "description": "Output only. The media type (MIME type) of the generated data.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitation": { "description": "Citation info for a segment.", "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitation", @@ -21371,6 +21665,15 @@ "description": "Chunk content.", "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryReferenceChunkContent", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "content": { "description": "Chunk textual content.", "type": "string" @@ -21408,6 +21711,14 @@ "description": "Summary with metadata information.", "id": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummarySummaryWithMetadata", "properties": { + "blobAttachments": { + "description": "Output only. Store multimodal data for answer enhancement.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment" + }, + "readOnly": true, + "type": "array" + }, "citationMetadata": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitationMetadata", "description": "Citation metadata for given summary." @@ -22753,6 +23064,10 @@ "description": "Whether web app access is enabled.", "type": "boolean" }, + "languageCode": { + "description": "Optional. Language code for user interface. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). If unset, the default language code is \"en-US\".", + "type": "string" + }, "workforceIdentityPoolProvider": { "description": "Optional. The workforce identity pool provider used to access the widget.", "type": "string" @@ -23283,6 +23598,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -25176,7 +25508,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -25209,6 +25541,10 @@ }, "type": "array" }, + "displaySpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec", + "description": "Optional. Config for display feature, like match highlighting on search results." + }, "embeddingSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec", "description": "Uses the provided embedding to do additional semantic document retrieval. The retrieval is based on the dot product of SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document embedding that is provided in SearchRequest.EmbeddingSpec.EmbeddingVector.field_path. If SearchRequest.EmbeddingSpec.EmbeddingVector.field_path is not provided, it will use ServingConfig.EmbeddingConfig.field_path." @@ -25601,6 +25937,10 @@ "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec", "description": "If specified, the spec will be used to modify the model specification provided to the LLM." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "description": "Optional. Multimodal specification." + }, "summaryResultCount": { "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.", "format": "int32", @@ -25635,6 +25975,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec": { "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec", @@ -25654,6 +26017,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec": { + "description": "Specifies features for display, like match highlighting.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec", + "properties": { + "matchHighlightingCondition": { + "description": "The condition under which match highlighting should occur.", + "enum": [ + "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED", + "MATCH_HIGHLIGHTING_DISABLED", + "MATCH_HIGHLIGHTING_ENABLED" + ], + "enumDescriptions": [ + "Server behavior is the same as `MATCH_HIGHLIGHTING_DISABLED`.", + "Disables match highlighting on all documents.", + "Enables match highlighting on all documents." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec": { "description": "The specification that uses customized query embedding vector to do semantic document retrieval.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec", diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index 8bacd4cbf9..fae5858341 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -202,6 +202,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.GroundingConfigs = NewProjectsLocationsGroundingConfigsService(s) rs.IdentityMappingStores = NewProjectsLocationsIdentityMappingStoresService(s) rs.Operations = NewProjectsLocationsOperationsService(s) + rs.Podcasts = NewProjectsLocationsPodcastsService(s) rs.RankingConfigs = NewProjectsLocationsRankingConfigsService(s) rs.Requirements = NewProjectsLocationsRequirementsService(s) rs.SampleQuerySets = NewProjectsLocationsSampleQuerySetsService(s) @@ -227,6 +228,8 @@ type ProjectsLocationsService struct { Operations *ProjectsLocationsOperationsService + Podcasts *ProjectsLocationsPodcastsService + RankingConfigs *ProjectsLocationsRankingConfigsService Requirements *ProjectsLocationsRequirementsService @@ -1045,6 +1048,27 @@ type ProjectsLocationsOperationsService struct { s *Service } +func NewProjectsLocationsPodcastsService(s *Service) *ProjectsLocationsPodcastsService { + rs := &ProjectsLocationsPodcastsService{s: s} + rs.Operations = NewProjectsLocationsPodcastsOperationsService(s) + return rs +} + +type ProjectsLocationsPodcastsService struct { + s *Service + + Operations *ProjectsLocationsPodcastsOperationsService +} + +func NewProjectsLocationsPodcastsOperationsService(s *Service) *ProjectsLocationsPodcastsOperationsService { + rs := &ProjectsLocationsPodcastsOperationsService{s: s} + return rs +} + +type ProjectsLocationsPodcastsOperationsService struct { + s *Service +} + func NewProjectsLocationsRankingConfigsService(s *Service) *ProjectsLocationsRankingConfigsService { rs := &ProjectsLocationsRankingConfigsService{s: s} return rs @@ -2627,6 +2651,15 @@ type GoogleCloudDiscoveryengineV1CmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1SingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -4705,7 +4738,8 @@ type GoogleCloudDiscoveryengineV1SearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -6146,6 +6180,63 @@ func (s GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig: The connector level +// alert config. +type GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig struct { + // AlertEnrollments: Optional. The enrollment states of each alert. + AlertEnrollments []*GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment `json:"alertEnrollments,omitempty"` + // AlertPolicyName: Immutable. The fully qualified resource name of the + // AlertPolicy. + AlertPolicyName string `json:"alertPolicyName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertEnrollments") 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. "AlertEnrollments") 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 GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment: The alert +// enrollment status. +type GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment struct { + // AlertId: Immutable. The id of an alert. + AlertId string `json:"alertId,omitempty"` + // EnrollState: Required. The enrollment status of a customer. + // + // Possible values: + // "ENROLL_STATES_UNSPECIFIED" - Default value. Used for customers who have + // not responded to the alert policy. + // "ENROLLED" - Customer is enrolled in this policy. + // "DECLINED" - Customer declined this policy. + EnrollState string `json:"enrollState,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertId") 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. "AlertId") 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 GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAlloyDbSource: AlloyDB source import data // from. type GoogleCloudDiscoveryengineV1alphaAlloyDbSource struct { @@ -6221,6 +6312,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` + // BlobAttachments: List of blob attachments in the answer. + BlobAttachments []*GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment `json:"blobAttachments,omitempty"` // Citations: Citations. Citations []*GoogleCloudDiscoveryengineV1alphaAnswerCitation `json:"citations,omitempty"` // CompleteTime: Output only. Answer completed timestamp. @@ -6290,6 +6383,63 @@ func (s *GoogleCloudDiscoveryengineV1alphaAnswer) UnmarshalJSON(data []byte) err return nil } +// GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment: Stores binarydata +// attached to text answer, e.g. image, video, audio, etc. +type GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment struct { + // AttributionType: Output only. The attribution type of the blob. + // + // Possible values: + // "ATTRIBUTION_TYPE_UNSPECIFIED" - Unspecified attribution type. + // "CORPUS" - The attachment data is from the corpus. + // "GENERATED" - The attachment data is generated by the model through code + // generation. + AttributionType string `json:"attributionType,omitempty"` + // Data: Output only. The mime type and data of the blob. + Data *GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributionType") 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. "AttributionType") 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 GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob: The media type +// and data of the blob. +type GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob struct { + // Data: Output only. Raw bytes. + Data string `json:"data,omitempty"` + // MimeType: Output only. The media type (MIME type) of the generated or + // retrieved data. + MimeType string `json:"mimeType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswerCitation: Citation info for a // segment. type GoogleCloudDiscoveryengineV1alphaAnswerCitation struct { @@ -6507,6 +6657,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpec str IncludeCitations bool `json:"includeCitations,omitempty"` // ModelSpec: Answer generation model specification. ModelSpec *GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec `json:"multimodalSpec,omitempty"` // PromptSpec: Answer generation prompt specification. PromptSpec *GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec `json:"promptSpec,omitempty"` // ForceSendFields is a list of field names (e.g. "AnswerLanguageCode") to @@ -6551,6 +6703,39 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecM return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultim +// odalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPrompt // Spec: Answer generation prompt specification. type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecPromptSpec struct { @@ -6706,17 +6891,20 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec) Marsha // GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec: // Query understanding specification. type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec struct { + // DisableSpellCorrection: Optional. Whether to disable spell correction. The + // default value is `false`. + DisableSpellCorrection bool `json:"disableSpellCorrection,omitempty"` // QueryClassificationSpec: Query classification specification. QueryClassificationSpec *GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec `json:"queryClassificationSpec,omitempty"` // QueryRephraserSpec: Query rephraser specification. QueryRephraserSpec *GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpec `json:"queryRephraserSpec,omitempty"` - // ForceSendFields is a list of field names (e.g. "QueryClassificationSpec") to + // ForceSendFields is a list of field names (e.g. "DisableSpellCorrection") 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. "QueryClassificationSpec") to + // NullFields is a list of field names (e.g. "DisableSpellCorrection") 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. @@ -7344,6 +7532,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerReference) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo: Chunk // information. type GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Chunk: Chunk resource name. Chunk string `json:"chunk,omitempty"` // Content: Chunk textual content. @@ -7355,15 +7546,15 @@ type GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo struct { // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Chunk") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Chunk") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -7483,6 +7674,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfo // GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunk // Content: Chunk content. type GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Content: Chunk textual content. Content string `json:"content,omitempty"` // PageIdentifier: Page identifier. @@ -7492,15 +7686,15 @@ type GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChu // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Content") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Content") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -8678,6 +8872,15 @@ type GoogleCloudDiscoveryengineV1alphaCmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1alphaSingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -9020,6 +9223,8 @@ type GoogleCloudDiscoveryengineV1alphaConnectorRun struct { // "CANCELLED" - Data sync was scheduled but has been cancelled. // "PENDING" - Data sync is about to start. // "WARNING" - The data sync completed with non-fatal errors. + // "SKIPPED" - An ongoing connector run has been running longer than + // expected, causing this run to be skipped. State string `json:"state,omitempty"` // StateUpdateTime: Timestamp at which the connector run sync state was last // updated. @@ -9090,6 +9295,8 @@ type GoogleCloudDiscoveryengineV1alphaConnectorRunEntityRun struct { // "CANCELLED" - Data sync was scheduled but has been cancelled. // "PENDING" - Data sync is about to start. // "WARNING" - The data sync completed with non-fatal errors. + // "SKIPPED" - An ongoing connector run has been running longer than + // expected, causing this run to be skipped. State string `json:"state,omitempty"` // StateUpdateTime: Timestamp at which the entity sync state was last updated. StateUpdateTime string `json:"stateUpdateTime,omitempty"` @@ -10030,6 +10237,8 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // ActionConfig: Optional. Action configurations to make the connector support // actions. ActionConfig *GoogleCloudDiscoveryengineV1alphaActionConfig `json:"actionConfig,omitempty"` + // AlertPolicyConfigs: Optional. The connector level alert config. + AlertPolicyConfigs []*GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig `json:"alertPolicyConfigs,omitempty"` // AutoRunDisabled: Indicates whether the connector is disabled for auto run. // It can be used to pause periodical and real time sync. AutoRunDisabled bool `json:"autoRunDisabled,omitempty"` @@ -16393,7 +16602,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -17083,6 +17293,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpec // ModelSpec: If specified, the spec will be used to modify the model // specification provided to the LLM. ModelSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec `json:"multimodalSpec,omitempty"` // SummaryResultCount: The number of top results to generate the summary from. // If the number of results returned is less than `summaryResultCount`, the // summary is generated from all of the results. At most 10 results for @@ -17168,6 +17380,39 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySp return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMul +// tiModalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec: A struct to // define data stores to filter on in a search call and configurations for // those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned. @@ -18380,6 +18625,62 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchResponseSummary) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment: Stores +// binarydata attached to text answer, e.g. image, video, audio, etc. +type GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment struct { + // AttributionType: Output only. The attribution type of the blob. + // + // Possible values: + // "ATTRIBUTION_TYPE_UNSPECIFIED" - Unspecified attribution type. + // "CORPUS" - The attachment data is from the corpus. + // "GENERATED" - The attachment data is generated by the model through code + // generation. + AttributionType string `json:"attributionType,omitempty"` + // Data: Output only. The blob data. + Data *GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributionType") 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. "AttributionType") 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 GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob: +// Stores type and data of the blob. +type GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob struct { + // Data: Output only. Raw bytes. + Data string `json:"data,omitempty"` + // MimeType: Output only. The media type (MIME type) of the generated data. + MimeType string `json:"mimeType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachmentBlob + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitation: Citation // info for a segment. type GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitation struct { @@ -18490,19 +18791,22 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryReference) Marshal // GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryReferenceChunkContent: // Chunk content. type GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryReferenceChunkContent struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Content: Chunk textual content. Content string `json:"content,omitempty"` // PageIdentifier: Page identifier. PageIdentifier string `json:"pageIdentifier,omitempty"` - // ForceSendFields is a list of field names (e.g. "Content") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Content") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -18559,19 +18863,21 @@ func (s *GoogleCloudDiscoveryengineV1alphaSearchResponseSummarySafetyAttributes) // GoogleCloudDiscoveryengineV1alphaSearchResponseSummarySummaryWithMetadata: // Summary with metadata information. type GoogleCloudDiscoveryengineV1alphaSearchResponseSummarySummaryWithMetadata struct { + // BlobAttachments: Output only. Store multimodal data for answer enhancement. + BlobAttachments []*GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryBlobAttachment `json:"blobAttachments,omitempty"` // CitationMetadata: Citation metadata for given summary. CitationMetadata *GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryCitationMetadata `json:"citationMetadata,omitempty"` // References: Document References. References []*GoogleCloudDiscoveryengineV1alphaSearchResponseSummaryReference `json:"references,omitempty"` // Summary: Summary text with no citation information. Summary string `json:"summary,omitempty"` - // ForceSendFields is a list of field names (e.g. "CitationMetadata") to + // ForceSendFields is a list of field names (e.g. "BlobAttachments") 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. "CitationMetadata") to include in + // NullFields is a list of field names (e.g. "BlobAttachments") 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. @@ -20242,6 +20548,10 @@ type GoogleCloudDiscoveryengineV1alphaWidgetConfigAccessSettings struct { AllowlistedDomains []string `json:"allowlistedDomains,omitempty"` // EnableWebApp: Whether web app access is enabled. EnableWebApp bool `json:"enableWebApp,omitempty"` + // LanguageCode: Optional. Language code for user interface. Use language tags + // defined by BCP47 (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). If unset, + // the default language code is "en-US". + LanguageCode string `json:"languageCode,omitempty"` // WorkforceIdentityPoolProvider: Optional. The workforce identity pool // provider used to access the widget. WorkforceIdentityPoolProvider string `json:"workforceIdentityPoolProvider,omitempty"` @@ -20890,6 +21200,15 @@ type GoogleCloudDiscoveryengineV1betaCmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1betaSingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -23476,7 +23795,8 @@ type GoogleCloudDiscoveryengineV1betaSearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -23525,6 +23845,9 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // considered for Engines with multiple data stores. For engines with a single // data store, the specs directly under SearchRequest should be used. DataStoreSpecs []*GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec `json:"dataStoreSpecs,omitempty"` + // DisplaySpec: Optional. Config for display feature, like match highlighting + // on search results. + DisplaySpec *GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec `json:"displaySpec,omitempty"` // EmbeddingSpec: Uses the provided embedding to do additional semantic // document retrieval. The retrieval is based on the dot product of // SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document @@ -24160,6 +24483,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec s // ModelSpec: If specified, the spec will be used to modify the model // specification provided to the LLM. ModelSpec *GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec `json:"multimodalSpec,omitempty"` // SummaryResultCount: The number of top results to generate the summary from. // If the number of results returned is less than `summaryResultCount`, the // summary is generated from all of the results. At most 10 results for @@ -24245,6 +24570,39 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpe return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMult +// iModalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec: A struct to // define data stores to filter on in a search call and configurations for // those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned. @@ -24280,6 +24638,38 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec) MarshalJSON( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec: Specifies features +// for display, like match highlighting. +type GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec struct { + // MatchHighlightingCondition: The condition under which match highlighting + // should occur. + // + // Possible values: + // "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED" - Server behavior is the same + // as `MATCH_HIGHLIGHTING_DISABLED`. + // "MATCH_HIGHLIGHTING_DISABLED" - Disables match highlighting on all + // documents. + // "MATCH_HIGHLIGHTING_ENABLED" - Enables match highlighting on all + // documents. + MatchHighlightingCondition string `json:"matchHighlightingCondition,omitempty"` + // ForceSendFields is a list of field names (e.g. "MatchHighlightingCondition") + // 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. "MatchHighlightingCondition") 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 GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec: The // specification that uses customized query embedding vector to do semantic // document retrieval. @@ -56450,6 +56840,118 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } +type ProjectsLocationsPodcastsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsPodcastsOperationsService) Get(name string) *ProjectsLocationsPodcastsOperationsGetCall { + c := &ProjectsLocationsPodcastsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsPodcastsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsPodcastsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsPodcastsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsPodcastsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPodcastsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.podcasts.operations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.podcasts.operations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.podcasts.operations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsRankingConfigsRankCall struct { s *Service rankingConfig string diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index 85e4b86963..4cc40566cb 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -7136,6 +7136,39 @@ } } }, + "podcasts": { + "resources": { + "operations": { + "methods": { + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/podcasts/{podcastsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.podcasts.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/podcasts/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "rankingConfigs": { "methods": { "rank": { @@ -7722,7 +7755,7 @@ } } }, - "revision": "20250306", + "revision": "20250314", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -8211,6 +8244,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -9748,7 +9798,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -10461,6 +10511,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig": { + "description": "The connector level alert config.", + "id": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig", + "properties": { + "alertEnrollments": { + "description": "Optional. The enrollment states of each alert.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment" + }, + "type": "array" + }, + "alertPolicyName": { + "description": "Immutable. The fully qualified resource name of the AlertPolicy.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment": { + "description": "The alert enrollment status.", + "id": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment", + "properties": { + "alertId": { + "description": "Immutable. The id of an alert.", + "type": "string" + }, + "enrollState": { + "description": "Required. The enrollment status of a customer.", + "enum": [ + "ENROLL_STATES_UNSPECIFIED", + "ENROLLED", + "DECLINED" + ], + "enumDescriptions": [ + "Default value. Used for customers who have not responded to the alert policy.", + "Customer is enrolled in this policy.", + "Customer declined this policy." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswer": { "description": "Defines an answer.", "id": "GoogleCloudDiscoveryengineV1alphaAnswer", @@ -10500,6 +10593,13 @@ "description": "The textual answer.", "type": "string" }, + "blobAttachments": { + "description": "List of blob attachments in the answer.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment" + }, + "type": "array" + }, "citations": { "description": "Citations.", "items": { @@ -10588,6 +10688,51 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment": { + "description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment", + "properties": { + "attributionType": { + "description": "Output only. The attribution type of the blob.", + "enum": [ + "ATTRIBUTION_TYPE_UNSPECIFIED", + "CORPUS", + "GENERATED" + ], + "enumDescriptions": [ + "Unspecified attribution type.", + "The attachment data is from the corpus.", + "The attachment data is generated by the model through code generation." + ], + "readOnly": true, + "type": "string" + }, + "data": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob", + "description": "Output only. The mime type and data of the blob.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob": { + "description": "The media type and data of the blob.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob", + "properties": { + "data": { + "description": "Output only. Raw bytes.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "mimeType": { + "description": "Output only. The media type (MIME type) of the generated or retrieved data.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswerCitation": { "description": "Citation info for a segment.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerCitation", @@ -10722,6 +10867,15 @@ "description": "Chunk information.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "chunk": { "description": "Chunk resource name.", "type": "string" @@ -10840,6 +10994,15 @@ "description": "Chunk content.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "content": { "description": "Chunk textual content.", "type": "string" @@ -11091,6 +11254,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -11261,7 +11441,8 @@ "OVERRUN", "CANCELLED", "PENDING", - "WARNING" + "WARNING", + "SKIPPED" ], "enumDescriptions": [ "Default value.", @@ -11271,7 +11452,8 @@ "Data sync has been running longer than expected and is still running at the time the next run is supposed to start.", "Data sync was scheduled but has been cancelled.", "Data sync is about to start.", - "The data sync completed with non-fatal errors." + "The data sync completed with non-fatal errors.", + "An ongoing connector run has been running longer than expected, causing this run to be skipped." ], "readOnly": true, "type": "string" @@ -11357,7 +11539,8 @@ "OVERRUN", "CANCELLED", "PENDING", - "WARNING" + "WARNING", + "SKIPPED" ], "enumDescriptions": [ "Default value.", @@ -11367,7 +11550,8 @@ "Data sync has been running longer than expected and is still running at the time the next run is supposed to start.", "Data sync was scheduled but has been cancelled.", "Data sync is about to start.", - "The data sync completed with non-fatal errors." + "The data sync completed with non-fatal errors.", + "An ongoing connector run has been running longer than expected, causing this run to be skipped." ], "type": "string" }, @@ -11773,6 +11957,13 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaActionConfig", "description": "Optional. Action configurations to make the connector support actions." }, + "alertPolicyConfigs": { + "description": "Optional. The connector level alert config.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig" + }, + "type": "array" + }, "autoRunDisabled": { "description": "Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync.", "type": "boolean" @@ -14350,7 +14541,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -14783,6 +14974,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec", "description": "If specified, the spec will be used to modify the model specification provided to the LLM." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "description": "Optional. Multimodal specification." + }, "summaryResultCount": { "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.", "format": "int32", @@ -14817,6 +15012,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec": { "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec", @@ -16031,6 +16249,13 @@ "description": "The textual answer.", "type": "string" }, + "blobAttachments": { + "description": "List of blob attachments in the answer.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment" + }, + "type": "array" + }, "citations": { "description": "Citations.", "items": { @@ -16119,6 +16344,51 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment": { + "description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.", + "id": "GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment", + "properties": { + "attributionType": { + "description": "Output only. The attribution type of the blob.", + "enum": [ + "ATTRIBUTION_TYPE_UNSPECIFIED", + "CORPUS", + "GENERATED" + ], + "enumDescriptions": [ + "Unspecified attribution type.", + "The attachment data is from the corpus.", + "The attachment data is generated by the model through code generation." + ], + "readOnly": true, + "type": "string" + }, + "data": { + "$ref": "GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob", + "description": "Output only. The mime type and data of the blob.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob": { + "description": "The media type and data of the blob.", + "id": "GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob", + "properties": { + "data": { + "description": "Output only. Raw bytes.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "mimeType": { + "description": "Output only. The media type (MIME type) of the generated or retrieved data.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAnswerCitation": { "description": "Citation info for a segment.", "id": "GoogleCloudDiscoveryengineV1betaAnswerCitation", @@ -16278,6 +16548,10 @@ "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecModelSpec", "description": "Answer generation model specification." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec", + "description": "Optional. Multimodal specification." + }, "promptSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPromptSpec", "description": "Answer generation prompt specification." @@ -16296,6 +16570,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPromptSpec": { "description": "Answer generation prompt specification.", "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPromptSpec", @@ -16387,6 +16684,10 @@ "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec", "properties": { + "disableSpellCorrection": { + "description": "Optional. Whether to disable spell correction. The default value is `false`.", + "type": "boolean" + }, "queryClassificationSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec", "description": "Query classification specification." @@ -16841,6 +17142,15 @@ "description": "Chunk information.", "id": "GoogleCloudDiscoveryengineV1betaAnswerReferenceChunkInfo", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "chunk": { "description": "Chunk resource name.", "type": "string" @@ -16959,6 +17269,15 @@ "description": "Chunk content.", "id": "GoogleCloudDiscoveryengineV1betaAnswerReferenceUnstructuredDocumentInfoChunkContent", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "content": { "description": "Chunk textual content.", "type": "string" @@ -17710,6 +18029,23 @@ "description": "Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`.", "type": "string" }, + "notebooklmState": { + "description": "Output only. Whether the NotebookLM Corpus is ready to be used.", + "enum": [ + "NOTEBOOK_LM_STATE_UNSPECIFIED", + "NOTEBOOK_LM_NOT_READY", + "NOTEBOOK_LM_READY", + "NOTEBOOK_LM_NOT_ENABLED" + ], + "enumDescriptions": [ + "The NotebookLM state is unknown.", + "The NotebookLM is not ready.", + "The NotebookLM is ready to be used.", + "The NotebookLM is not enabled." + ], + "readOnly": true, + "type": "string" + }, "singleRegionKeys": { "description": "Optional. Single-regional CMEKs that are required for some VAIS features.", "items": { @@ -21607,7 +21943,7 @@ "type": "string" }, "uri": { - "description": "Required. The URL for the page the user wants to promote.", + "description": "Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.", "type": "string" } }, @@ -21640,6 +21976,10 @@ }, "type": "array" }, + "displaySpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec", + "description": "Optional. Config for display feature, like match highlighting on search results." + }, "embeddingSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec", "description": "Uses the provided embedding to do additional semantic document retrieval. The retrieval is based on the dot product of SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document embedding that is provided in SearchRequest.EmbeddingSpec.EmbeddingVector.field_path. If SearchRequest.EmbeddingSpec.EmbeddingVector.field_path is not provided, it will use ServingConfig.EmbeddingConfig.field_path." @@ -22032,6 +22372,10 @@ "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec", "description": "If specified, the spec will be used to modify the model specification provided to the LLM." }, + "multimodalSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "description": "Optional. Multimodal specification." + }, "summaryResultCount": { "description": "The number of top results to generate the summary from. If the number of results returned is less than `summaryResultCount`, the summary is generated from all of the results. At most 10 results for documents mode, or 50 for chunks mode, can be used to generate a summary. The chunks mode is used when SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.", "format": "int32", @@ -22066,6 +22410,29 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec": { + "description": "Multimodal specification: Will return an image from specified source. If multiple sources are specified, the pick is a quality based decision.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec", + "properties": { + "imageSource": { + "description": "Optional. Source of image returned in the answer.", + "enum": [ + "IMAGE_SOURCE_UNSPECIFIED", + "ALL_AVAILABLE_SOURCES", + "CORPUS_IMAGE_ONLY", + "FIGURE_GENERATION_ONLY" + ], + "enumDescriptions": [ + "Unspecified image source (multimodal feature is disabled by default).", + "Behavior when service determines the pick from all available sources.", + "Includes image from corpus in the answer.", + "Triggers figure generation in the answer." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec": { "description": "A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec", @@ -22085,6 +22452,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec": { + "description": "Specifies features for display, like match highlighting.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec", + "properties": { + "matchHighlightingCondition": { + "description": "The condition under which match highlighting should occur.", + "enum": [ + "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED", + "MATCH_HIGHLIGHTING_DISABLED", + "MATCH_HIGHLIGHTING_ENABLED" + ], + "enumDescriptions": [ + "Server behavior is the same as `MATCH_HIGHLIGHTING_DISABLED`.", + "Disables match highlighting on all documents.", + "Enables match highlighting on all documents." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec": { "description": "The specification that uses customized query embedding vector to do semantic document retrieval.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec", @@ -22875,6 +23263,51 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment": { + "description": "Stores binarydata attached to text answer, e.g. image, video, audio, etc.", + "id": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment", + "properties": { + "attributionType": { + "description": "Output only. The attribution type of the blob.", + "enum": [ + "ATTRIBUTION_TYPE_UNSPECIFIED", + "CORPUS", + "GENERATED" + ], + "enumDescriptions": [ + "Unspecified attribution type.", + "The attachment data is from the corpus.", + "The attachment data is generated by the model through code generation." + ], + "readOnly": true, + "type": "string" + }, + "data": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob", + "description": "Output only. The blob data.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob": { + "description": "Stores type and data of the blob.", + "id": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob", + "properties": { + "data": { + "description": "Output only. Raw bytes.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "mimeType": { + "description": "Output only. The media type (MIME type) of the generated data.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryCitation": { "description": "Citation info for a segment.", "id": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryCitation", @@ -22955,6 +23388,15 @@ "description": "Chunk content.", "id": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryReferenceChunkContent", "properties": { + "blobAttachmentIndexes": { + "description": "Output only. Stores indexes of blobattachments linked to this chunk.", + "items": { + "format": "int64", + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "content": { "description": "Chunk textual content.", "type": "string" @@ -22992,6 +23434,14 @@ "description": "Summary with metadata information.", "id": "GoogleCloudDiscoveryengineV1betaSearchResponseSummarySummaryWithMetadata", "properties": { + "blobAttachments": { + "description": "Output only. Store multimodal data for answer enhancement.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment" + }, + "readOnly": true, + "type": "array" + }, "citationMetadata": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponseSummaryCitationMetadata", "description": "Citation metadata for given summary." diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 229a1ec925..766cc6f870 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -180,6 +180,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.GroundingConfigs = NewProjectsLocationsGroundingConfigsService(s) rs.IdentityMappingStores = NewProjectsLocationsIdentityMappingStoresService(s) rs.Operations = NewProjectsLocationsOperationsService(s) + rs.Podcasts = NewProjectsLocationsPodcastsService(s) rs.RankingConfigs = NewProjectsLocationsRankingConfigsService(s) rs.SampleQuerySets = NewProjectsLocationsSampleQuerySetsService(s) rs.UserEvents = NewProjectsLocationsUserEventsService(s) @@ -201,6 +202,8 @@ type ProjectsLocationsService struct { Operations *ProjectsLocationsOperationsService + Podcasts *ProjectsLocationsPodcastsService + RankingConfigs *ProjectsLocationsRankingConfigsService SampleQuerySets *ProjectsLocationsSampleQuerySetsService @@ -934,6 +937,27 @@ type ProjectsLocationsOperationsService struct { s *Service } +func NewProjectsLocationsPodcastsService(s *Service) *ProjectsLocationsPodcastsService { + rs := &ProjectsLocationsPodcastsService{s: s} + rs.Operations = NewProjectsLocationsPodcastsOperationsService(s) + return rs +} + +type ProjectsLocationsPodcastsService struct { + s *Service + + Operations *ProjectsLocationsPodcastsOperationsService +} + +func NewProjectsLocationsPodcastsOperationsService(s *Service) *ProjectsLocationsPodcastsOperationsService { + rs := &ProjectsLocationsPodcastsOperationsService{s: s} + return rs +} + +type ProjectsLocationsPodcastsOperationsService struct { + s *Service +} + func NewProjectsLocationsRankingConfigsService(s *Service) *ProjectsLocationsRankingConfigsService { rs := &ProjectsLocationsRankingConfigsService{s: s} return rs @@ -1816,6 +1840,15 @@ type GoogleCloudDiscoveryengineV1CmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1SingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -3894,7 +3927,8 @@ type GoogleCloudDiscoveryengineV1SearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -4909,6 +4943,63 @@ func (s GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig: The connector level +// alert config. +type GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig struct { + // AlertEnrollments: Optional. The enrollment states of each alert. + AlertEnrollments []*GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment `json:"alertEnrollments,omitempty"` + // AlertPolicyName: Immutable. The fully qualified resource name of the + // AlertPolicy. + AlertPolicyName string `json:"alertPolicyName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertEnrollments") 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. "AlertEnrollments") 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 GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment: The alert +// enrollment status. +type GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment struct { + // AlertId: Immutable. The id of an alert. + AlertId string `json:"alertId,omitempty"` + // EnrollState: Required. The enrollment status of a customer. + // + // Possible values: + // "ENROLL_STATES_UNSPECIFIED" - Default value. Used for customers who have + // not responded to the alert policy. + // "ENROLLED" - Customer is enrolled in this policy. + // "DECLINED" - Customer declined this policy. + EnrollState string `json:"enrollState,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertId") 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. "AlertId") 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 GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAlertPolicyConfigAlertEnrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswer: Defines an answer. type GoogleCloudDiscoveryengineV1alphaAnswer struct { // AnswerSkippedReasons: Additional answer-skipped reasons. This provides the @@ -4941,6 +5032,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` + // BlobAttachments: List of blob attachments in the answer. + BlobAttachments []*GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment `json:"blobAttachments,omitempty"` // Citations: Citations. Citations []*GoogleCloudDiscoveryengineV1alphaAnswerCitation `json:"citations,omitempty"` // CompleteTime: Output only. Answer completed timestamp. @@ -5007,6 +5100,63 @@ func (s *GoogleCloudDiscoveryengineV1alphaAnswer) UnmarshalJSON(data []byte) err return nil } +// GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment: Stores binarydata +// attached to text answer, e.g. image, video, audio, etc. +type GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment struct { + // AttributionType: Output only. The attribution type of the blob. + // + // Possible values: + // "ATTRIBUTION_TYPE_UNSPECIFIED" - Unspecified attribution type. + // "CORPUS" - The attachment data is from the corpus. + // "GENERATED" - The attachment data is generated by the model through code + // generation. + AttributionType string `json:"attributionType,omitempty"` + // Data: Output only. The mime type and data of the blob. + Data *GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributionType") 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. "AttributionType") 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 GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob: The media type +// and data of the blob. +type GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob struct { + // Data: Output only. Raw bytes. + Data string `json:"data,omitempty"` + // MimeType: Output only. The media type (MIME type) of the generated or + // retrieved data. + MimeType string `json:"mimeType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswerCitation: Citation info for a // segment. type GoogleCloudDiscoveryengineV1alphaAnswerCitation struct { @@ -5197,6 +5347,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerReference) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo: Chunk // information. type GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Chunk: Chunk resource name. Chunk string `json:"chunk,omitempty"` // Content: Chunk textual content. @@ -5208,15 +5361,15 @@ type GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo struct { // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Chunk") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Chunk") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -5336,6 +5489,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfo // GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunk // Content: Chunk content. type GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Content: Chunk textual content. Content string `json:"content,omitempty"` // PageIdentifier: Page identifier. @@ -5345,15 +5501,15 @@ type GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChu // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Content") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Content") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -5684,6 +5840,15 @@ type GoogleCloudDiscoveryengineV1alphaCmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1alphaSingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -5878,6 +6043,8 @@ type GoogleCloudDiscoveryengineV1alphaConnectorRun struct { // "CANCELLED" - Data sync was scheduled but has been cancelled. // "PENDING" - Data sync is about to start. // "WARNING" - The data sync completed with non-fatal errors. + // "SKIPPED" - An ongoing connector run has been running longer than + // expected, causing this run to be skipped. State string `json:"state,omitempty"` // StateUpdateTime: Timestamp at which the connector run sync state was last // updated. @@ -5945,6 +6112,8 @@ type GoogleCloudDiscoveryengineV1alphaConnectorRunEntityRun struct { // "CANCELLED" - Data sync was scheduled but has been cancelled. // "PENDING" - Data sync is about to start. // "WARNING" - The data sync completed with non-fatal errors. + // "SKIPPED" - An ongoing connector run has been running longer than + // expected, causing this run to be skipped. State string `json:"state,omitempty"` // StateUpdateTime: Timestamp at which the entity sync state was last updated. StateUpdateTime string `json:"stateUpdateTime,omitempty"` @@ -6554,6 +6723,8 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // ActionConfig: Optional. Action configurations to make the connector support // actions. ActionConfig *GoogleCloudDiscoveryengineV1alphaActionConfig `json:"actionConfig,omitempty"` + // AlertPolicyConfigs: Optional. The connector level alert config. + AlertPolicyConfigs []*GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig `json:"alertPolicyConfigs,omitempty"` // AutoRunDisabled: Indicates whether the connector is disabled for auto run. // It can be used to pause periodical and real time sync. AutoRunDisabled bool `json:"autoRunDisabled,omitempty"` @@ -9845,7 +10016,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -10535,6 +10707,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpec // ModelSpec: If specified, the spec will be used to modify the model // specification provided to the LLM. ModelSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec `json:"multimodalSpec,omitempty"` // SummaryResultCount: The number of top results to generate the summary from. // If the number of results returned is less than `summaryResultCount`, the // summary is generated from all of the results. At most 10 results for @@ -10620,6 +10794,39 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySp return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMul +// tiModalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec: A struct to // define data stores to filter on in a search call and configurations for // those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned. @@ -12347,6 +12554,8 @@ type GoogleCloudDiscoveryengineV1betaAnswer struct { AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` + // BlobAttachments: List of blob attachments in the answer. + BlobAttachments []*GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment `json:"blobAttachments,omitempty"` // Citations: Citations. Citations []*GoogleCloudDiscoveryengineV1betaAnswerCitation `json:"citations,omitempty"` // CompleteTime: Output only. Answer completed timestamp. @@ -12416,6 +12625,63 @@ func (s *GoogleCloudDiscoveryengineV1betaAnswer) UnmarshalJSON(data []byte) erro return nil } +// GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment: Stores binarydata +// attached to text answer, e.g. image, video, audio, etc. +type GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment struct { + // AttributionType: Output only. The attribution type of the blob. + // + // Possible values: + // "ATTRIBUTION_TYPE_UNSPECIFIED" - Unspecified attribution type. + // "CORPUS" - The attachment data is from the corpus. + // "GENERATED" - The attachment data is generated by the model through code + // generation. + AttributionType string `json:"attributionType,omitempty"` + // Data: Output only. The mime type and data of the blob. + Data *GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributionType") 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. "AttributionType") 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 GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAnswerBlobAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob: The media type and +// data of the blob. +type GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob struct { + // Data: Output only. Raw bytes. + Data string `json:"data,omitempty"` + // MimeType: Output only. The media type (MIME type) of the generated or + // retrieved data. + MimeType string `json:"mimeType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAnswerBlobAttachmentBlob + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaAnswerCitation: Citation info for a segment. type GoogleCloudDiscoveryengineV1betaAnswerCitation struct { // EndIndex: End of the attributed segment, exclusive. Measured in bytes (UTF-8 @@ -12632,6 +12898,8 @@ type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpec stru IncludeCitations bool `json:"includeCitations,omitempty"` // ModelSpec: Answer generation model specification. ModelSpec *GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec `json:"multimodalSpec,omitempty"` // PromptSpec: Answer generation prompt specification. PromptSpec *GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPromptSpec `json:"promptSpec,omitempty"` // ForceSendFields is a list of field names (e.g. "AnswerLanguageCode") to @@ -12676,6 +12944,39 @@ func (s GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMo return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimo +// dalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecMultimodalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPromptS // pec: Answer generation prompt specification. type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPromptSpec struct { @@ -12832,17 +13133,20 @@ func (s GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec) Marshal // GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec: // Query understanding specification. type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec struct { + // DisableSpellCorrection: Optional. Whether to disable spell correction. The + // default value is `false`. + DisableSpellCorrection bool `json:"disableSpellCorrection,omitempty"` // QueryClassificationSpec: Query classification specification. QueryClassificationSpec *GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpecQueryClassificationSpec `json:"queryClassificationSpec,omitempty"` // QueryRephraserSpec: Query rephraser specification. QueryRephraserSpec *GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpecQueryRephraserSpec `json:"queryRephraserSpec,omitempty"` - // ForceSendFields is a list of field names (e.g. "QueryClassificationSpec") to + // ForceSendFields is a list of field names (e.g. "DisableSpellCorrection") 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. "QueryClassificationSpec") to + // NullFields is a list of field names (e.g. "DisableSpellCorrection") 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. @@ -13468,6 +13772,9 @@ func (s GoogleCloudDiscoveryengineV1betaAnswerReference) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1betaAnswerReferenceChunkInfo: Chunk information. type GoogleCloudDiscoveryengineV1betaAnswerReferenceChunkInfo struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Chunk: Chunk resource name. Chunk string `json:"chunk,omitempty"` // Content: Chunk textual content. @@ -13479,15 +13786,15 @@ type GoogleCloudDiscoveryengineV1betaAnswerReferenceChunkInfo struct { // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Chunk") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Chunk") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -13607,6 +13914,9 @@ func (s GoogleCloudDiscoveryengineV1betaAnswerReferenceUnstructuredDocumentInfo) // GoogleCloudDiscoveryengineV1betaAnswerReferenceUnstructuredDocumentInfoChunkC // ontent: Chunk content. type GoogleCloudDiscoveryengineV1betaAnswerReferenceUnstructuredDocumentInfoChunkContent struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Content: Chunk textual content. Content string `json:"content,omitempty"` // PageIdentifier: Page identifier. @@ -13616,15 +13926,15 @@ type GoogleCloudDiscoveryengineV1betaAnswerReferenceUnstructuredDocumentInfoChun // for informational purpose only. It may change for the same query and chunk // at any time due to a model retraining or change in implementation. RelevanceScore float64 `json:"relevanceScore,omitempty"` - // ForceSendFields is a list of field names (e.g. "Content") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Content") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -14658,6 +14968,15 @@ type GoogleCloudDiscoveryengineV1betaCmekConfig struct { // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}`. Name string `json:"name,omitempty"` + // NotebooklmState: Output only. Whether the NotebookLM Corpus is ready to be + // used. + // + // Possible values: + // "NOTEBOOK_LM_STATE_UNSPECIFIED" - The NotebookLM state is unknown. + // "NOTEBOOK_LM_NOT_READY" - The NotebookLM is not ready. + // "NOTEBOOK_LM_READY" - The NotebookLM is ready to be used. + // "NOTEBOOK_LM_NOT_ENABLED" - The NotebookLM is not enabled. + NotebooklmState string `json:"notebooklmState,omitempty"` // SingleRegionKeys: Optional. Single-regional CMEKs that are required for some // VAIS features. SingleRegionKeys []*GoogleCloudDiscoveryengineV1betaSingleRegionKey `json:"singleRegionKeys,omitempty"` @@ -20302,7 +20621,8 @@ type GoogleCloudDiscoveryengineV1betaSearchLinkPromotion struct { ImageUri string `json:"imageUri,omitempty"` // Title: Required. The title of the promotion. Maximum length: 160 characters. Title string `json:"title,omitempty"` - // Uri: Required. The URL for the page the user wants to promote. + // Uri: Optional. The URL for the page the user wants to promote. Must be set + // for site search. For other verticals, this is optional. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or @@ -20351,6 +20671,9 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // considered for Engines with multiple data stores. For engines with a single // data store, the specs directly under SearchRequest should be used. DataStoreSpecs []*GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec `json:"dataStoreSpecs,omitempty"` + // DisplaySpec: Optional. Config for display feature, like match highlighting + // on search results. + DisplaySpec *GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec `json:"displaySpec,omitempty"` // EmbeddingSpec: Uses the provided embedding to do additional semantic // document retrieval. The retrieval is based on the dot product of // SearchRequest.EmbeddingSpec.EmbeddingVector.vector and the document @@ -20986,6 +21309,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec s // ModelSpec: If specified, the spec will be used to modify the model // specification provided to the LLM. ModelSpec *GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec `json:"modelSpec,omitempty"` + // MultimodalSpec: Optional. Multimodal specification. + MultimodalSpec *GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec `json:"multimodalSpec,omitempty"` // SummaryResultCount: The number of top results to generate the summary from. // If the number of results returned is less than `summaryResultCount`, the // summary is generated from all of the results. At most 10 results for @@ -21071,6 +21396,39 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpe return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMult +// iModalSpec: Multimodal specification: Will return an image from specified +// source. If multiple sources are specified, the pick is a quality based +// decision. +type GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec struct { + // ImageSource: Optional. Source of image returned in the answer. + // + // Possible values: + // "IMAGE_SOURCE_UNSPECIFIED" - Unspecified image source (multimodal feature + // is disabled by default). + // "ALL_AVAILABLE_SOURCES" - Behavior when service determines the pick from + // all available sources. + // "CORPUS_IMAGE_ONLY" - Includes image from corpus in the answer. + // "FIGURE_GENERATION_ONLY" - Triggers figure generation in the answer. + ImageSource string `json:"imageSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "ImageSource") 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. "ImageSource") 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 GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec: A struct to // define data stores to filter on in a search call and configurations for // those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned. @@ -21106,6 +21464,38 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec) MarshalJSON( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec: Specifies features +// for display, like match highlighting. +type GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec struct { + // MatchHighlightingCondition: The condition under which match highlighting + // should occur. + // + // Possible values: + // "MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED" - Server behavior is the same + // as `MATCH_HIGHLIGHTING_DISABLED`. + // "MATCH_HIGHLIGHTING_DISABLED" - Disables match highlighting on all + // documents. + // "MATCH_HIGHLIGHTING_ENABLED" - Enables match highlighting on all + // documents. + MatchHighlightingCondition string `json:"matchHighlightingCondition,omitempty"` + // ForceSendFields is a list of field names (e.g. "MatchHighlightingCondition") + // 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. "MatchHighlightingCondition") 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 GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec: The // specification that uses customized query embedding vector to do semantic // document retrieval. @@ -22251,6 +22641,62 @@ func (s GoogleCloudDiscoveryengineV1betaSearchResponseSummary) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment: Stores +// binarydata attached to text answer, e.g. image, video, audio, etc. +type GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment struct { + // AttributionType: Output only. The attribution type of the blob. + // + // Possible values: + // "ATTRIBUTION_TYPE_UNSPECIFIED" - Unspecified attribution type. + // "CORPUS" - The attachment data is from the corpus. + // "GENERATED" - The attachment data is generated by the model through code + // generation. + AttributionType string `json:"attributionType,omitempty"` + // Data: Output only. The blob data. + Data *GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributionType") 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. "AttributionType") 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 GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob: +// Stores type and data of the blob. +type GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob struct { + // Data: Output only. Raw bytes. + Data string `json:"data,omitempty"` + // MimeType: Output only. The media type (MIME type) of the generated data. + MimeType string `json:"mimeType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachmentBlob + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchResponseSummaryCitation: Citation info // for a segment. type GoogleCloudDiscoveryengineV1betaSearchResponseSummaryCitation struct { @@ -22361,19 +22807,22 @@ func (s GoogleCloudDiscoveryengineV1betaSearchResponseSummaryReference) MarshalJ // GoogleCloudDiscoveryengineV1betaSearchResponseSummaryReferenceChunkContent: // Chunk content. type GoogleCloudDiscoveryengineV1betaSearchResponseSummaryReferenceChunkContent struct { + // BlobAttachmentIndexes: Output only. Stores indexes of blobattachments linked + // to this chunk. + BlobAttachmentIndexes googleapi.Int64s `json:"blobAttachmentIndexes,omitempty"` // Content: Chunk textual content. Content string `json:"content,omitempty"` // PageIdentifier: Page identifier. PageIdentifier string `json:"pageIdentifier,omitempty"` - // ForceSendFields is a list of field names (e.g. "Content") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BlobAttachmentIndexes") 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. "Content") 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. "BlobAttachmentIndexes") 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:"-"` } @@ -22430,19 +22879,21 @@ func (s *GoogleCloudDiscoveryengineV1betaSearchResponseSummarySafetyAttributes) // GoogleCloudDiscoveryengineV1betaSearchResponseSummarySummaryWithMetadata: // Summary with metadata information. type GoogleCloudDiscoveryengineV1betaSearchResponseSummarySummaryWithMetadata struct { + // BlobAttachments: Output only. Store multimodal data for answer enhancement. + BlobAttachments []*GoogleCloudDiscoveryengineV1betaSearchResponseSummaryBlobAttachment `json:"blobAttachments,omitempty"` // CitationMetadata: Citation metadata for given summary. CitationMetadata *GoogleCloudDiscoveryengineV1betaSearchResponseSummaryCitationMetadata `json:"citationMetadata,omitempty"` // References: Document References. References []*GoogleCloudDiscoveryengineV1betaSearchResponseSummaryReference `json:"references,omitempty"` // Summary: Summary text with no citation information. Summary string `json:"summary,omitempty"` - // ForceSendFields is a list of field names (e.g. "CitationMetadata") to + // ForceSendFields is a list of field names (e.g. "BlobAttachments") 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. "CitationMetadata") to include in + // NullFields is a list of field names (e.g. "BlobAttachments") 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. @@ -50490,6 +50941,118 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } +type ProjectsLocationsPodcastsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsPodcastsOperationsService) Get(name string) *ProjectsLocationsPodcastsOperationsGetCall { + c := &ProjectsLocationsPodcastsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsPodcastsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsPodcastsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsPodcastsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsPodcastsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPodcastsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.podcasts.operations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.podcasts.operations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsPodcastsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.podcasts.operations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsRankingConfigsRankCall struct { s *Service rankingConfig string diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index d192285368..d7a975e0b7 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -8010,7 +8010,7 @@ } } }, - "revision": "20250220", + "revision": "20250313", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -13564,7 +13564,7 @@ "type": "integer" }, "timeUnit": { - "description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value `TIME_UNIT_LIFETIME`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).", + "description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`.", "enum": [ "TIME_UNIT_UNSPECIFIED", "TIME_UNIT_LIFETIME", @@ -13574,6 +13574,15 @@ "TIME_UNIT_HOURS", "TIME_UNIT_MINUTES" ], + "enumDeprecated": [ + false, + true, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Time unit value is not specified or is unknown in this version.", "The frequency cap will be applied to the whole life time of the line item.", @@ -13586,7 +13595,7 @@ "type": "string" }, "timeUnitCount": { - "description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value 2 if the value of time_unit is `TIME_UNIT_MONTHS`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).", + "description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59", "format": "int32", "type": "integer" }, @@ -14545,7 +14554,7 @@ }, "frequencyCap": { "$ref": "FrequencyCap", - "description": "Required. The frequency capping setting of the insertion order. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "Required. The frequency capping setting of the insertion order." }, "insertionOrderId": { "description": "Output only. The unique ID of the insertion order. Assigned by the system.", @@ -15662,7 +15671,7 @@ }, "frequencyCap": { "$ref": "FrequencyCap", - "description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap." }, "insertionOrderId": { "description": "Required. Immutable. The unique ID of the insertion order that the line item belongs to.", @@ -18558,6 +18567,15 @@ "TIME_UNIT_HOURS", "TIME_UNIT_MINUTES" ], + "enumDeprecated": [ + false, + true, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Time unit value is not specified or is unknown in this version.", "The frequency cap will be applied to the whole life time of the line item.", @@ -19903,7 +19921,7 @@ }, "viewFrequencyCap": { "$ref": "FrequencyCap", - "description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap." } }, "type": "object" diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index b645f26c11..2f68d9804c 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -7139,11 +7139,7 @@ type FrequencyCap struct { // Required when unlimited is `false` and max_impressions is not set. MaxViews int64 `json:"maxViews,omitempty"` // TimeUnit: The time unit in which the frequency cap will be applied. Required - // when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency - // cap time periods greater than 30 days will no longer be accepted. This field - // will no longer accept the value `TIME_UNIT_LIFETIME`. Read more about this - // announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap). + // when unlimited is `false`. // // Possible values: // "TIME_UNIT_UNSPECIFIED" - Time unit value is not specified or is unknown @@ -7162,15 +7158,10 @@ type FrequencyCap struct { TimeUnit string `json:"timeUnit,omitempty"` // TimeUnitCount: The number of time_unit the frequency cap will last. Required // when unlimited is `false`. The following restrictions apply based on the - // value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and - // will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * - // `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be - // between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * - // `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, - // 2025**, frequency cap time periods greater than 30 days will no longer be - // accepted. This field will no longer accept the value 2 if the value of - // time_unit is `TIME_UNIT_MONTHS`. Read more about this announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap). + // value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - + // must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * + // `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be + // between 1 and 59 TimeUnitCount int64 `json:"timeUnitCount,omitempty"` // Unlimited: Whether unlimited frequency capping is applied. When this field // is set to `true`, the remaining frequency cap fields are not applicable. @@ -8106,10 +8097,7 @@ type InsertionOrder struct { // deletion. EntityStatus string `json:"entityStatus,omitempty"` // FrequencyCap: Required. The frequency capping setting of the insertion - // order. *Warning*: On **February 28, 2025**, frequency cap time periods - // greater than 30 days will no longer be accepted. Read more about this - // announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap) + // order. FrequencyCap *FrequencyCap `json:"frequencyCap,omitempty"` // InsertionOrderId: Output only. The unique ID of the insertion order. // Assigned by the system. @@ -9203,10 +9191,7 @@ type LineItem struct { Flight *LineItemFlight `json:"flight,omitempty"` // FrequencyCap: Required. The impression frequency cap settings of the line // item. The max_impressions field in this settings object must be used if - // assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap - // time periods greater than 30 days will no longer be accepted. Read more - // about this announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap) + // assigning a limited cap. FrequencyCap *FrequencyCap `json:"frequencyCap,omitempty"` // InsertionOrderId: Required. Immutable. The unique ID of the insertion order // that the line item belongs to. @@ -14575,9 +14560,7 @@ type YoutubeAndPartnersSettings struct { VideoAdSequenceSettings *VideoAdSequenceSettings `json:"videoAdSequenceSettings,omitempty"` // ViewFrequencyCap: The view frequency cap settings of the line item. The // max_views field in this settings object must be used if assigning a limited - // cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater - // than 30 days will no longer be accepted. Read more about this announced - // change (/display-video/api/deprecations#features.lifetime_frequency_cap) + // cap. ViewFrequencyCap *FrequencyCap `json:"viewFrequencyCap,omitempty"` // ForceSendFields is a list of field names (e.g. "BiddingStrategy") to // unconditionally include in API requests. By default, fields with empty or diff --git a/displayvideo/v3/displayvideo-api.json b/displayvideo/v3/displayvideo-api.json index b38fb71718..77ce1d2afc 100644 --- a/displayvideo/v3/displayvideo-api.json +++ b/displayvideo/v3/displayvideo-api.json @@ -6271,7 +6271,7 @@ "type": "string" }, "pageSize": { - "description": "Requested page size. Must be between `1` and `5000`. If unspecified, this value defaults to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. *Warning*: Starting **March 6, 2025**, this value will default to `5000` if not set.", + "description": "Requested page size. Must be between `1` and `5000`. If unspecified, this value defaults to `5000`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.", "format": "int32", "location": "query", "type": "integer" @@ -9256,7 +9256,7 @@ } } }, - "revision": "20250220", + "revision": "20250313", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -16304,7 +16304,7 @@ "type": "integer" }, "timeUnit": { - "description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value `TIME_UNIT_LIFETIME`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).", + "description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`.", "enum": [ "TIME_UNIT_UNSPECIFIED", "TIME_UNIT_LIFETIME", @@ -16314,6 +16314,15 @@ "TIME_UNIT_HOURS", "TIME_UNIT_MINUTES" ], + "enumDeprecated": [ + false, + true, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Time unit value is not specified or is unknown in this version.", "The frequency cap will be applied to the whole life time of the line item.", @@ -16326,7 +16335,7 @@ "type": "string" }, "timeUnitCount": { - "description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value 2 if the value of time_unit is `TIME_UNIT_MONTHS`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).", + "description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59", "format": "int32", "type": "integer" }, @@ -17279,7 +17288,7 @@ }, "frequencyCap": { "$ref": "FrequencyCap", - "description": "Required. The frequency capping setting of the insertion order. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "Required. The frequency capping setting of the insertion order." }, "insertionOrderId": { "description": "Output only. The unique ID of the insertion order. Assigned by the system.", @@ -18500,7 +18509,7 @@ }, "frequencyCap": { "$ref": "FrequencyCap", - "description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap." }, "insertionOrderId": { "description": "Required. Immutable. The unique ID of the insertion order that the line item belongs to.", @@ -21431,6 +21440,15 @@ "TIME_UNIT_HOURS", "TIME_UNIT_MINUTES" ], + "enumDeprecated": [ + false, + true, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Time unit value is not specified or is unknown in this version.", "The frequency cap will be applied to the whole life time of the line item.", @@ -21479,7 +21497,7 @@ "type": "boolean" }, "enableOptimizedTargeting": { - "description": "Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to `true` for a line item using one of the following combinations of BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in an error: maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` performance_goal_auto_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` *Warning*: Starting **March 6, 2025**, this field will stop being compatible when using the BiddingStrategy field fixed_bid. [Read more about this announced change](/display-video/api/deprecations#features.ot_fixed_bid)", + "description": "Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to `true` for a line item using the BiddingStrategy field fixed_bid or one of the following combinations of BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in an error: maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` performance_goal_auto_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`", "type": "boolean" } }, @@ -22594,7 +22612,7 @@ }, "viewFrequencyCap": { "$ref": "FrequencyCap", - "description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap." } }, "type": "object" diff --git a/displayvideo/v3/displayvideo-gen.go b/displayvideo/v3/displayvideo-gen.go index c1f4162e5f..a521838fb0 100644 --- a/displayvideo/v3/displayvideo-gen.go +++ b/displayvideo/v3/displayvideo-gen.go @@ -8703,11 +8703,7 @@ type FrequencyCap struct { // Required when unlimited is `false` and max_impressions is not set. MaxViews int64 `json:"maxViews,omitempty"` // TimeUnit: The time unit in which the frequency cap will be applied. Required - // when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency - // cap time periods greater than 30 days will no longer be accepted. This field - // will no longer accept the value `TIME_UNIT_LIFETIME`. Read more about this - // announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap). + // when unlimited is `false`. // // Possible values: // "TIME_UNIT_UNSPECIFIED" - Time unit value is not specified or is unknown @@ -8726,15 +8722,10 @@ type FrequencyCap struct { TimeUnit string `json:"timeUnit,omitempty"` // TimeUnitCount: The number of time_unit the frequency cap will last. Required // when unlimited is `false`. The following restrictions apply based on the - // value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and - // will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * - // `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be - // between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * - // `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, - // 2025**, frequency cap time periods greater than 30 days will no longer be - // accepted. This field will no longer accept the value 2 if the value of - // time_unit is `TIME_UNIT_MONTHS`. Read more about this announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap). + // value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - + // must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * + // `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be + // between 1 and 59 TimeUnitCount int64 `json:"timeUnitCount,omitempty"` // Unlimited: Whether unlimited frequency capping is applied. When this field // is set to `true`, the remaining frequency cap fields are not applicable. @@ -9668,10 +9659,7 @@ type InsertionOrder struct { // deletion. EntityStatus string `json:"entityStatus,omitempty"` // FrequencyCap: Required. The frequency capping setting of the insertion - // order. *Warning*: On **February 28, 2025**, frequency cap time periods - // greater than 30 days will no longer be accepted. Read more about this - // announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap) + // order. FrequencyCap *FrequencyCap `json:"frequencyCap,omitempty"` // InsertionOrderId: Output only. The unique ID of the insertion order. // Assigned by the system. @@ -10863,10 +10851,7 @@ type LineItem struct { Flight *LineItemFlight `json:"flight,omitempty"` // FrequencyCap: Required. The impression frequency cap settings of the line // item. The max_impressions field in this settings object must be used if - // assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap - // time periods greater than 30 days will no longer be accepted. Read more - // about this announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap) + // assigning a limited cap. FrequencyCap *FrequencyCap `json:"frequencyCap,omitempty"` // InsertionOrderId: Required. Immutable. The unique ID of the insertion order // that the line item belongs to. @@ -14928,17 +14913,15 @@ type TargetingExpansionConfig struct { AudienceExpansionSeedListExcluded bool `json:"audienceExpansionSeedListExcluded,omitempty"` // EnableOptimizedTargeting: Required. Whether to enable Optimized Targeting // for the line item. Optimized targeting is not compatible with all bid - // strategies. Attempting to set this field to `true` for a line item using one - // of the following combinations of BiddingStrategy fields and - // BiddingStrategyPerformanceGoalType will result in an error: - // maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * + // strategies. Attempting to set this field to `true` for a line item using the + // BiddingStrategy field fixed_bid or one of the following combinations of + // BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in + // an error: maximize_auto_spend_bid: * + // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` // performance_goal_auto_bid: * - // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` *Warning*: Starting - // **March 6, 2025**, this field will stop being compatible when using the - // BiddingStrategy field fixed_bid. Read more about this announced change - // (/display-video/api/deprecations#features.ot_fixed_bid) + // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` EnableOptimizedTargeting bool `json:"enableOptimizedTargeting,omitempty"` // ForceSendFields is a list of field names (e.g. "AudienceExpansionLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -16168,9 +16151,7 @@ type YoutubeAndPartnersSettings struct { VideoAdSequenceSettings *VideoAdSequenceSettings `json:"videoAdSequenceSettings,omitempty"` // ViewFrequencyCap: The view frequency cap settings of the line item. The // max_views field in this settings object must be used if assigning a limited - // cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater - // than 30 days will no longer be accepted. Read more about this announced - // change (/display-video/api/deprecations#features.lifetime_frequency_cap) + // cap. ViewFrequencyCap *FrequencyCap `json:"viewFrequencyCap,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentCategory") to // unconditionally include in API requests. By default, fields with empty or @@ -30524,10 +30505,8 @@ func (c *FirstAndThirdPartyAudiencesListCall) OrderBy(orderBy string) *FirstAndT } // PageSize sets the optional parameter "pageSize": Requested page size. Must -// be between `1` and `5000`. If unspecified, this value defaults to `100`. +// be between `1` and `5000`. If unspecified, this value defaults to `5000`. // Returns error code `INVALID_ARGUMENT` if an invalid value is specified. -// *Warning*: Starting **March 6, 2025**, this value will default to `5000` if -// not set. func (c *FirstAndThirdPartyAudiencesListCall) PageSize(pageSize int64) *FirstAndThirdPartyAudiencesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c diff --git a/displayvideo/v4/displayvideo-api.json b/displayvideo/v4/displayvideo-api.json index 545dc3c13c..c7b86e251c 100644 --- a/displayvideo/v4/displayvideo-api.json +++ b/displayvideo/v4/displayvideo-api.json @@ -8185,7 +8185,7 @@ } } }, - "revision": "20250220", + "revision": "20250313", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -14937,7 +14937,7 @@ "type": "string" }, "membershipDurationDays": { - "description": "Output only. The duration in days that an entry remains in the audience after the qualifying event. If the audience has no expiration, set the value of this field to 10000. Otherwise, the set value must be greater than 0 and less than or equal to 540. Only applicable to first party audiences. This field is required if one of the following audience_type is used: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`", + "description": "Output only. The duration in days that an entry remains in the audience after the qualifying event. If the audience has no expiration, set the value of this field to 10000. Otherwise, the set value must be greater than 0 and less than or equal to 540. Only applicable to first party audiences. This field is required if one of the following audience_type is used: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID` *Warning*: Starting on **April 7, 2025**, audiences will no longer be able to have infinite membership duration. This field will no longer accept the value 10000 and all audiences with membership durations greater than 540 days will be updated to a membership duration of 540 days. [Read more about this announced change](/display-video/api/deprecations#features.audience_duration).", "format": "int64", "readOnly": true, "type": "string" @@ -15198,7 +15198,7 @@ "type": "integer" }, "timeUnit": { - "description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value `TIME_UNIT_LIFETIME`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).", + "description": "The time unit in which the frequency cap will be applied. Required when unlimited is `false`.", "enum": [ "TIME_UNIT_UNSPECIFIED", "TIME_UNIT_LIFETIME", @@ -15208,6 +15208,15 @@ "TIME_UNIT_HOURS", "TIME_UNIT_MINUTES" ], + "enumDeprecated": [ + false, + true, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Time unit value is not specified or is unknown in this version.", "The frequency cap will be applied to the whole life time of the line item.", @@ -15220,7 +15229,7 @@ "type": "string" }, "timeUnitCount": { - "description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. This field will no longer accept the value 2 if the value of time_unit is `TIME_UNIT_MONTHS`. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap).", + "description": "The number of time_unit the frequency cap will last. Required when unlimited is `false`. The following restrictions apply based on the value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be between 1 and 59", "format": "int32", "type": "integer" }, @@ -16173,7 +16182,7 @@ }, "frequencyCap": { "$ref": "FrequencyCap", - "description": "Required. The frequency capping setting of the insertion order. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "Required. The frequency capping setting of the insertion order." }, "insertionOrderId": { "description": "Output only. The unique ID of the insertion order. Assigned by the system.", @@ -17394,7 +17403,7 @@ }, "frequencyCap": { "$ref": "FrequencyCap", - "description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "Required. The impression frequency cap settings of the line item. The max_impressions field in this settings object must be used if assigning a limited cap." }, "insertionOrderId": { "description": "Required. Immutable. The unique ID of the insertion order that the line item belongs to.", @@ -20255,6 +20264,15 @@ "TIME_UNIT_HOURS", "TIME_UNIT_MINUTES" ], + "enumDeprecated": [ + false, + true, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Time unit value is not specified or is unknown in this version.", "The frequency cap will be applied to the whole life time of the line item.", @@ -20303,7 +20321,7 @@ "type": "boolean" }, "enableOptimizedTargeting": { - "description": "Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to `true` for a line item using one of the following combinations of BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in an error: maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` performance_goal_auto_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` *Warning*: Starting **March 6, 2025**, this field will stop being compatible when using the BiddingStrategy field fixed_bid. [Read more about this announced change](/display-video/api/deprecations#features.ot_fixed_bid)", + "description": "Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to `true` for a line item using the BiddingStrategy field fixed_bid or one of the following combinations of BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in an error: maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` performance_goal_auto_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`", "type": "boolean" } }, @@ -21418,7 +21436,7 @@ }, "viewFrequencyCap": { "$ref": "FrequencyCap", - "description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater than 30 days will no longer be accepted. [Read more about this announced change](/display-video/api/deprecations#features.lifetime_frequency_cap)" + "description": "The view frequency cap settings of the line item. The max_views field in this settings object must be used if assigning a limited cap." } }, "type": "object" diff --git a/displayvideo/v4/displayvideo-gen.go b/displayvideo/v4/displayvideo-gen.go index 218ede87bd..8d2bec4195 100644 --- a/displayvideo/v4/displayvideo-gen.go +++ b/displayvideo/v4/displayvideo-gen.go @@ -8308,7 +8308,12 @@ type FirstPartyAndPartnerAudience struct { // must be greater than 0 and less than or equal to 540. Only applicable to // first party audiences. This field is required if one of the following // audience_type is used: * `CUSTOMER_MATCH_CONTACT_INFO` * - // `CUSTOMER_MATCH_DEVICE_ID` + // `CUSTOMER_MATCH_DEVICE_ID` *Warning*: Starting on **April 7, 2025**, + // audiences will no longer be able to have infinite membership duration. This + // field will no longer accept the value 10000 and all audiences with + // membership durations greater than 540 days will be updated to a membership + // duration of 540 days. Read more about this announced change + // (/display-video/api/deprecations#features.audience_duration). MembershipDurationDays int64 `json:"membershipDurationDays,omitempty,string"` // MobileDeviceIdList: Input only. A list of mobile device IDs to define the // initial audience members. Only applicable to audience_type @@ -8588,11 +8593,7 @@ type FrequencyCap struct { // Required when unlimited is `false` and max_impressions is not set. MaxViews int64 `json:"maxViews,omitempty"` // TimeUnit: The time unit in which the frequency cap will be applied. Required - // when unlimited is `false`. *Warning*: On **February 28, 2025**, frequency - // cap time periods greater than 30 days will no longer be accepted. This field - // will no longer accept the value `TIME_UNIT_LIFETIME`. Read more about this - // announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap). + // when unlimited is `false`. // // Possible values: // "TIME_UNIT_UNSPECIFIED" - Time unit value is not specified or is unknown @@ -8611,15 +8612,10 @@ type FrequencyCap struct { TimeUnit string `json:"timeUnit,omitempty"` // TimeUnitCount: The number of time_unit the frequency cap will last. Required // when unlimited is `false`. The following restrictions apply based on the - // value of time_unit: * `TIME_UNIT_LIFETIME` - this field is output only and - // will default to 1 * `TIME_UNIT_MONTHS` - must be between 1 and 2 * - // `TIME_UNIT_WEEKS` - must be between 1 and 4 * `TIME_UNIT_DAYS` - must be - // between 1 and 6 * `TIME_UNIT_HOURS` - must be between 1 and 23 * - // `TIME_UNIT_MINUTES` - must be between 1 and 59 *Warning*: On **February 28, - // 2025**, frequency cap time periods greater than 30 days will no longer be - // accepted. This field will no longer accept the value 2 if the value of - // time_unit is `TIME_UNIT_MONTHS`. Read more about this announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap). + // value of time_unit: * `TIME_UNIT_MONTHS` - must be 1 * `TIME_UNIT_WEEKS` - + // must be between 1 and 4 * `TIME_UNIT_DAYS` - must be between 1 and 6 * + // `TIME_UNIT_HOURS` - must be between 1 and 23 * `TIME_UNIT_MINUTES` - must be + // between 1 and 59 TimeUnitCount int64 `json:"timeUnitCount,omitempty"` // Unlimited: Whether unlimited frequency capping is applied. When this field // is set to `true`, the remaining frequency cap fields are not applicable. @@ -9553,10 +9549,7 @@ type InsertionOrder struct { // deletion. EntityStatus string `json:"entityStatus,omitempty"` // FrequencyCap: Required. The frequency capping setting of the insertion - // order. *Warning*: On **February 28, 2025**, frequency cap time periods - // greater than 30 days will no longer be accepted. Read more about this - // announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap) + // order. FrequencyCap *FrequencyCap `json:"frequencyCap,omitempty"` // InsertionOrderId: Output only. The unique ID of the insertion order. // Assigned by the system. @@ -10748,10 +10741,7 @@ type LineItem struct { Flight *LineItemFlight `json:"flight,omitempty"` // FrequencyCap: Required. The impression frequency cap settings of the line // item. The max_impressions field in this settings object must be used if - // assigning a limited cap. *Warning*: On **February 28, 2025**, frequency cap - // time periods greater than 30 days will no longer be accepted. Read more - // about this announced change - // (/display-video/api/deprecations#features.lifetime_frequency_cap) + // assigning a limited cap. FrequencyCap *FrequencyCap `json:"frequencyCap,omitempty"` // InsertionOrderId: Required. Immutable. The unique ID of the insertion order // that the line item belongs to. @@ -14716,17 +14706,15 @@ type TargetingExpansionConfig struct { AudienceExpansionSeedListExcluded bool `json:"audienceExpansionSeedListExcluded,omitempty"` // EnableOptimizedTargeting: Required. Whether to enable Optimized Targeting // for the line item. Optimized targeting is not compatible with all bid - // strategies. Attempting to set this field to `true` for a line item using one - // of the following combinations of BiddingStrategy fields and - // BiddingStrategyPerformanceGoalType will result in an error: - // maximize_auto_spend_bid: * `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * + // strategies. Attempting to set this field to `true` for a line item using the + // BiddingStrategy field fixed_bid or one of the following combinations of + // BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in + // an error: maximize_auto_spend_bid: * + // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` * // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` * // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` // performance_goal_auto_bid: * - // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` *Warning*: Starting - // **March 6, 2025**, this field will stop being compatible when using the - // BiddingStrategy field fixed_bid. Read more about this announced change - // (/display-video/api/deprecations#features.ot_fixed_bid) + // `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` EnableOptimizedTargeting bool `json:"enableOptimizedTargeting,omitempty"` // ForceSendFields is a list of field names (e.g. "AudienceExpansionLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -15956,9 +15944,7 @@ type YoutubeAndPartnersSettings struct { VideoAdSequenceSettings *VideoAdSequenceSettings `json:"videoAdSequenceSettings,omitempty"` // ViewFrequencyCap: The view frequency cap settings of the line item. The // max_views field in this settings object must be used if assigning a limited - // cap. *Warning*: On **February 28, 2025**, frequency cap time periods greater - // than 30 days will no longer be accepted. Read more about this announced - // change (/display-video/api/deprecations#features.lifetime_frequency_cap) + // cap. ViewFrequencyCap *FrequencyCap `json:"viewFrequencyCap,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentCategory") to // unconditionally include in API requests. By default, fields with empty or diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index 98a212da2d..111c40104a 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -1480,6 +1480,50 @@ } } }, + "infoTypes": { + "methods": { + "list": { + "description": "Returns a list of the sensitive information types that the DLP API supports. See https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference to learn more.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/infoTypes", + "httpMethod": "GET", + "id": "dlp.organizations.locations.infoTypes.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "filter to only return infoTypes supported by certain parts of the API. Defaults to supported_by=INSPECT.", + "location": "query", + "type": "string" + }, + "languageCode": { + "description": "BCP-47 language code for localized infoType friendly names. If omitted, or if localized strings are not available, en-US strings will be returned.", + "location": "query", + "type": "string" + }, + "locationId": { + "description": "Deprecated. This field has no effect.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "The parent resource name. The format of this value is as follows: `locations/{location_id}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/infoTypes", + "response": { + "$ref": "GooglePrivacyDlpV2ListInfoTypesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "inspectTemplates": { "methods": { "create": { @@ -4145,6 +4189,50 @@ } } }, + "infoTypes": { + "methods": { + "list": { + "description": "Returns a list of the sensitive information types that the DLP API supports. See https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference to learn more.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/infoTypes", + "httpMethod": "GET", + "id": "dlp.projects.locations.infoTypes.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "filter to only return infoTypes supported by certain parts of the API. Defaults to supported_by=INSPECT.", + "location": "query", + "type": "string" + }, + "languageCode": { + "description": "BCP-47 language code for localized infoType friendly names. If omitted, or if localized strings are not available, en-US strings will be returned.", + "location": "query", + "type": "string" + }, + "locationId": { + "description": "Deprecated. This field has no effect.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "The parent resource name. The format of this value is as follows: `locations/{location_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/infoTypes", + "response": { + "$ref": "GooglePrivacyDlpV2ListInfoTypesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "inspectTemplates": { "methods": { "create": { @@ -5025,7 +5113,7 @@ } } }, - "revision": "20250305", + "revision": "20250309", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -8636,6 +8724,13 @@ "The profile is no longer generating. If profile_status.status.code is 0, the profile succeeded, otherwise, it failed." ], "type": "string" + }, + "tags": { + "description": "The tags attached to the resource, including any tags attached during profiling.", + "items": { + "$ref": "GooglePrivacyDlpV2Tag" + }, + "type": "array" } }, "type": "object" @@ -9253,6 +9348,13 @@ "$ref": "GooglePrivacyDlpV2SensitivityScore", "description": "The default sensitivity of the infoType." }, + "specificInfoTypes": { + "description": "If this field is set, this infoType is a general infoType and these specific infoTypes are contained within it. General infoTypes are infoTypes that encompass multiple specific infoTypes. For example, the \"GEOGRAPHIC_DATA\" general infoType would have set for this field \"LOCATION\", \"LOCATION_COORDINATES\", and \"STREET_ADDRESS\".", + "items": { + "type": "string" + }, + "type": "array" + }, "supportedBy": { "description": "Which parts of the API supports this InfoType.", "items": { @@ -11946,6 +12048,13 @@ "description": "The size of the table when the profile was generated.", "format": "int64", "type": "string" + }, + "tags": { + "description": "The tags attached to the table, including any tags attached during profiling. Because tags are attached to Cloud SQL instances rather than Cloud SQL tables, this field is empty for Cloud SQL table profiles.", + "items": { + "$ref": "GooglePrivacyDlpV2Tag" + }, + "type": "array" } }, "type": "object" @@ -11991,6 +12100,25 @@ }, "type": "object" }, + "GooglePrivacyDlpV2Tag": { + "description": "A tag associated with a resource.", + "id": "GooglePrivacyDlpV2Tag", + "properties": { + "key": { + "description": "The key of a tag key-value pair. For Google Cloud resources, this is the resource name of the key, for example, \"tagKeys/123456\".", + "type": "string" + }, + "namespacedTagValue": { + "description": "The namespaced name for the tag value to attach to Google Cloud resources. Must be in the format `{parent_id}/{tag_key_short_name}/{short_name}`, for example, \"123456/environment/prod\". This is only set for Google Cloud resources.", + "type": "string" + }, + "value": { + "description": "The value of a tag key-value pair. For Google Cloud resources, this is the resource name of the value, for example, \"tagValues/123456\".", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2TagCondition": { "description": "The tag to attach to profiles matching the condition. At most one `TagCondition` can be specified per sensitivity level.", "id": "GooglePrivacyDlpV2TagCondition", diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 3c85de129d..9e38cb6ebc 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -245,6 +245,7 @@ func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService rs.DiscoveryConfigs = NewOrganizationsLocationsDiscoveryConfigsService(s) rs.DlpJobs = NewOrganizationsLocationsDlpJobsService(s) rs.FileStoreDataProfiles = NewOrganizationsLocationsFileStoreDataProfilesService(s) + rs.InfoTypes = NewOrganizationsLocationsInfoTypesService(s) rs.InspectTemplates = NewOrganizationsLocationsInspectTemplatesService(s) rs.JobTriggers = NewOrganizationsLocationsJobTriggersService(s) rs.ProjectDataProfiles = NewOrganizationsLocationsProjectDataProfilesService(s) @@ -268,6 +269,8 @@ type OrganizationsLocationsService struct { FileStoreDataProfiles *OrganizationsLocationsFileStoreDataProfilesService + InfoTypes *OrganizationsLocationsInfoTypesService + InspectTemplates *OrganizationsLocationsInspectTemplatesService JobTriggers *OrganizationsLocationsJobTriggersService @@ -333,6 +336,15 @@ type OrganizationsLocationsFileStoreDataProfilesService struct { s *Service } +func NewOrganizationsLocationsInfoTypesService(s *Service) *OrganizationsLocationsInfoTypesService { + rs := &OrganizationsLocationsInfoTypesService{s: s} + return rs +} + +type OrganizationsLocationsInfoTypesService struct { + s *Service +} + func NewOrganizationsLocationsInspectTemplatesService(s *Service) *OrganizationsLocationsInspectTemplatesService { rs := &OrganizationsLocationsInspectTemplatesService{s: s} return rs @@ -484,6 +496,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.DlpJobs = NewProjectsLocationsDlpJobsService(s) rs.FileStoreDataProfiles = NewProjectsLocationsFileStoreDataProfilesService(s) rs.Image = NewProjectsLocationsImageService(s) + rs.InfoTypes = NewProjectsLocationsInfoTypesService(s) rs.InspectTemplates = NewProjectsLocationsInspectTemplatesService(s) rs.JobTriggers = NewProjectsLocationsJobTriggersService(s) rs.ProjectDataProfiles = NewProjectsLocationsProjectDataProfilesService(s) @@ -511,6 +524,8 @@ type ProjectsLocationsService struct { Image *ProjectsLocationsImageService + InfoTypes *ProjectsLocationsInfoTypesService + InspectTemplates *ProjectsLocationsInspectTemplatesService JobTriggers *ProjectsLocationsJobTriggersService @@ -594,6 +609,15 @@ type ProjectsLocationsImageService struct { s *Service } +func NewProjectsLocationsInfoTypesService(s *Service) *ProjectsLocationsInfoTypesService { + rs := &ProjectsLocationsInfoTypesService{s: s} + return rs +} + +type ProjectsLocationsInfoTypesService struct { + s *Service +} + func NewProjectsLocationsInspectTemplatesService(s *Service) *ProjectsLocationsInspectTemplatesService { rs := &ProjectsLocationsInspectTemplatesService{s: s} return rs @@ -5561,6 +5585,9 @@ type GooglePrivacyDlpV2FileStoreDataProfile struct { // profile_status.status.code is 0, the profile succeeded, otherwise, it // failed. State string `json:"state,omitempty"` + // Tags: The tags attached to the resource, including any tags attached during + // profiling. + Tags []*GooglePrivacyDlpV2Tag `json:"tags,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -6369,6 +6396,12 @@ type GooglePrivacyDlpV2InfoTypeDescription struct { Name string `json:"name,omitempty"` // SensitivityScore: The default sensitivity of the infoType. SensitivityScore *GooglePrivacyDlpV2SensitivityScore `json:"sensitivityScore,omitempty"` + // SpecificInfoTypes: If this field is set, this infoType is a general infoType + // and these specific infoTypes are contained within it. General infoTypes are + // infoTypes that encompass multiple specific infoTypes. For example, the + // "GEOGRAPHIC_DATA" general infoType would have set for this field "LOCATION", + // "LOCATION_COORDINATES", and "STREET_ADDRESS". + SpecificInfoTypes []string `json:"specificInfoTypes,omitempty"` // SupportedBy: Which parts of the API supports this InfoType. // // Possible values: @@ -10101,6 +10134,10 @@ type GooglePrivacyDlpV2TableDataProfile struct { TableId string `json:"tableId,omitempty"` // TableSizeBytes: The size of the table when the profile was generated. TableSizeBytes int64 `json:"tableSizeBytes,omitempty,string"` + // Tags: The tags attached to the table, including any tags attached during + // profiling. Because tags are attached to Cloud SQL instances rather than + // Cloud SQL tables, this field is empty for Cloud SQL table profiles. + Tags []*GooglePrivacyDlpV2Tag `json:"tags,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -10200,6 +10237,37 @@ func (s GooglePrivacyDlpV2TableReference) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2Tag: A tag associated with a resource. +type GooglePrivacyDlpV2Tag struct { + // Key: The key of a tag key-value pair. For Google Cloud resources, this is + // the resource name of the key, for example, "tagKeys/123456". + Key string `json:"key,omitempty"` + // NamespacedTagValue: The namespaced name for the tag value to attach to + // Google Cloud resources. Must be in the format + // `{parent_id}/{tag_key_short_name}/{short_name}`, for example, + // "123456/environment/prod". This is only set for Google Cloud resources. + NamespacedTagValue string `json:"namespacedTagValue,omitempty"` + // Value: The value of a tag key-value pair. For Google Cloud resources, this + // is the resource name of the value, for example, "tagValues/123456". + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") 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. "Key") 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 GooglePrivacyDlpV2Tag) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2Tag + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2TagCondition: The tag to attach to profiles matching the // condition. At most one `TagCondition` can be specified per sensitivity // level. @@ -15801,6 +15869,142 @@ func (c *OrganizationsLocationsFileStoreDataProfilesListCall) Pages(ctx context. } } +type OrganizationsLocationsInfoTypesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Returns a list of the sensitive information types that the DLP API +// supports. See +// https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference +// to learn more. +// +// - parent: The parent resource name. The format of this value is as follows: +// `locations/{location_id}`. +func (r *OrganizationsLocationsInfoTypesService) List(parent string) *OrganizationsLocationsInfoTypesListCall { + c := &OrganizationsLocationsInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": filter to only return infoTypes +// supported by certain parts of the API. Defaults to supported_by=INSPECT. +func (c *OrganizationsLocationsInfoTypesListCall) Filter(filter string) *OrganizationsLocationsInfoTypesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// LanguageCode sets the optional parameter "languageCode": BCP-47 language +// code for localized infoType friendly names. If omitted, or if localized +// strings are not available, en-US strings will be returned. +func (c *OrganizationsLocationsInfoTypesListCall) LanguageCode(languageCode string) *OrganizationsLocationsInfoTypesListCall { + c.urlParams_.Set("languageCode", languageCode) + return c +} + +// LocationId sets the optional parameter "locationId": Deprecated. This field +// has no effect. +func (c *OrganizationsLocationsInfoTypesListCall) LocationId(locationId string) *OrganizationsLocationsInfoTypesListCall { + c.urlParams_.Set("locationId", locationId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsLocationsInfoTypesListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInfoTypesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *OrganizationsLocationsInfoTypesListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsInfoTypesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsInfoTypesListCall) Context(ctx context.Context) *OrganizationsLocationsInfoTypesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsLocationsInfoTypesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsInfoTypesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/infoTypes") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dlp.organizations.locations.infoTypes.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dlp.organizations.locations.infoTypes.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GooglePrivacyDlpV2ListInfoTypesResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsInfoTypesListCall) Do(opts ...googleapi.CallOption) (*GooglePrivacyDlpV2ListInfoTypesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GooglePrivacyDlpV2ListInfoTypesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dlp.organizations.locations.infoTypes.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type OrganizationsLocationsInspectTemplatesCreateCall struct { s *Service parentid string @@ -26127,6 +26331,142 @@ func (c *ProjectsLocationsImageRedactCall) Do(opts ...googleapi.CallOption) (*Go return ret, nil } +type ProjectsLocationsInfoTypesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Returns a list of the sensitive information types that the DLP API +// supports. See +// https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference +// to learn more. +// +// - parent: The parent resource name. The format of this value is as follows: +// `locations/{location_id}`. +func (r *ProjectsLocationsInfoTypesService) List(parent string) *ProjectsLocationsInfoTypesListCall { + c := &ProjectsLocationsInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": filter to only return infoTypes +// supported by certain parts of the API. Defaults to supported_by=INSPECT. +func (c *ProjectsLocationsInfoTypesListCall) Filter(filter string) *ProjectsLocationsInfoTypesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// LanguageCode sets the optional parameter "languageCode": BCP-47 language +// code for localized infoType friendly names. If omitted, or if localized +// strings are not available, en-US strings will be returned. +func (c *ProjectsLocationsInfoTypesListCall) LanguageCode(languageCode string) *ProjectsLocationsInfoTypesListCall { + c.urlParams_.Set("languageCode", languageCode) + return c +} + +// LocationId sets the optional parameter "locationId": Deprecated. This field +// has no effect. +func (c *ProjectsLocationsInfoTypesListCall) LocationId(locationId string) *ProjectsLocationsInfoTypesListCall { + c.urlParams_.Set("locationId", locationId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsInfoTypesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsInfoTypesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsInfoTypesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsInfoTypesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsInfoTypesListCall) Context(ctx context.Context) *ProjectsLocationsInfoTypesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsInfoTypesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsInfoTypesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/infoTypes") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dlp.projects.locations.infoTypes.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dlp.projects.locations.infoTypes.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GooglePrivacyDlpV2ListInfoTypesResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsInfoTypesListCall) Do(opts ...googleapi.CallOption) (*GooglePrivacyDlpV2ListInfoTypesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GooglePrivacyDlpV2ListInfoTypesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dlp.projects.locations.infoTypes.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsInspectTemplatesCreateCall struct { s *Service parentid string diff --git a/doubleclickbidmanager/v2/doubleclickbidmanager-api.json b/doubleclickbidmanager/v2/doubleclickbidmanager-api.json index 50ea71e658..338a9c4b2c 100644 --- a/doubleclickbidmanager/v2/doubleclickbidmanager-api.json +++ b/doubleclickbidmanager/v2/doubleclickbidmanager-api.json @@ -319,7 +319,7 @@ } } }, - "revision": "20240731", + "revision": "20250305", "rootUrl": "https://doubleclickbidmanager.googleapis.com/", "schemas": { "DataRange": { @@ -513,7 +513,7 @@ "enumDeprecated": [ false, false, - false, + true, true, false, false, @@ -527,7 +527,7 @@ "enumDescriptions": [ "Default value when report type is not specified or is unknown in this version.", "Standard report.", - "Inventory Availability report.", + "Inventory Availability report. See the [Display \u0026 Video 360 Help Center announcement](https://support.google.com/displayvideo/answer/15874746) for more information on this deprecation.", "Audience Composition report.", "Floodlight report.", "YouTube report.", diff --git a/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go b/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go index 15bd859e48..292dee3079 100644 --- a/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go +++ b/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go @@ -399,7 +399,10 @@ type Parameters struct { // "REPORT_TYPE_UNSPECIFIED" - Default value when report type is not // specified or is unknown in this version. // "STANDARD" - Standard report. - // "INVENTORY_AVAILABILITY" - Inventory Availability report. + // "INVENTORY_AVAILABILITY" - Inventory Availability report. See the [Display + // & Video 360 Help Center + // announcement](https://support.google.com/displayvideo/answer/15874746) for + // more information on this deprecation. // "AUDIENCE_COMPOSITION" - Audience Composition report. // "FLOODLIGHT" - Floodlight report. // "YOUTUBE" - YouTube report. diff --git a/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index 6f0f023216..d5e2f40b94 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-api.json @@ -2460,7 +2460,7 @@ } } }, - "revision": "20250228", + "revision": "20250307", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -2967,6 +2967,13 @@ "description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.", "type": "string" }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels.", + "type": "object" + }, "name": { "description": "Required. The resource name of the config. Must be in the format of, `projects/{project}/locations/{location}/googleChannelConfig`. In API responses, the config name always includes the projectID, regardless of whether the projectID or projectNumber was provided.", "type": "string" diff --git a/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index 95a09a4493..050f7343bd 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -992,6 +992,8 @@ type GoogleChannelConfig struct { // user) used to encrypt/decrypt their event data. It must match the pattern // `projects/*/locations/*/keyRings/*/cryptoKeys/*`. CryptoKeyName string `json:"cryptoKeyName,omitempty"` + // Labels: Optional. Resource labels. + Labels map[string]string `json:"labels,omitempty"` // Name: Required. The resource name of the config. Must be in the format of, // `projects/{project}/locations/{location}/googleChannelConfig`. In API // responses, the config name always includes the projectID, regardless of diff --git a/fcm/v1/fcm-api.json b/fcm/v1/fcm-api.json index 23ed563a7d..571c2a045d 100644 --- a/fcm/v1/fcm-api.json +++ b/fcm/v1/fcm-api.json @@ -122,7 +122,7 @@ ], "parameters": { "parent": { - "description": "Required. It contains the Firebase project id (i.e. the unique identifier for your Firebase project), in the format of `projects/{project_id}`. For legacy support, the numeric project number with no padding is also supported in the format of `projects/{project_number}`.", + "description": "Required. It contains the Firebase project id (i.e. the unique identifier for your Firebase project), in the format of `projects/{project_id}`. The numeric project number with no padding is also supported in the format of `projects/{project_number}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -146,7 +146,7 @@ } } }, - "revision": "20250228", + "revision": "20250311", "rootUrl": "https://fcm.googleapis.com/", "schemas": { "AndroidConfig": { diff --git a/fcm/v1/fcm-gen.go b/fcm/v1/fcm-gen.go index a1e1f07f67..17d776f295 100644 --- a/fcm/v1/fcm-gen.go +++ b/fcm/v1/fcm-gen.go @@ -895,9 +895,9 @@ type ProjectsMessagesSendCall struct { // condition). // // - parent: It contains the Firebase project id (i.e. the unique identifier -// for your Firebase project), in the format of `projects/{project_id}`. For -// legacy support, the numeric project number with no padding is also -// supported in the format of `projects/{project_number}`. +// for your Firebase project), in the format of `projects/{project_id}`. The +// numeric project number with no padding is also supported in the format of +// `projects/{project_number}`. func (r *ProjectsMessagesService) Send(parentid string, sendmessagerequest *SendMessageRequest) *ProjectsMessagesSendCall { c := &ProjectsMessagesSendCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parentid = parentid diff --git a/firebase/v1beta1/firebase-api.json b/firebase/v1beta1/firebase-api.json index 63241f801b..8a5c93705c 100644 --- a/firebase/v1beta1/firebase-api.json +++ b/firebase/v1beta1/firebase-api.json @@ -1324,7 +1324,7 @@ } } }, - "revision": "20250303", + "revision": "20250314", "rootUrl": "https://firebase.googleapis.com/", "schemas": { "AddFirebaseRequest": { @@ -1919,7 +1919,6 @@ "type": "object" }, "MessageSet": { - "description": "This is proto2's version of MessageSet.", "id": "MessageSet", "properties": {}, "type": "object" diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 688f236f6e..de5133271d 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -1236,7 +1236,6 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// MessageSet: This is proto2's version of MessageSet. type MessageSet struct { } diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json index 3e72821097..bc6b1c3931 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json @@ -831,7 +831,7 @@ } } }, - "revision": "20250303", + "revision": "20250314", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { @@ -1885,7 +1885,7 @@ ], "enumDescriptions": [ "Reason unspecified.", - "The goal was impossible to accomplish.", + "The goal failed to be completed. Note that \"impossible\" is a legacy term and the goal is reported to the customer as having \"failed\".", "The goal was completed successfully." ], "readOnly": true, diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go index 20a8b9fd4f..0246cdbb38 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go @@ -1502,7 +1502,9 @@ type GoogleFirebaseAppdistroV1alphaTerminalAction struct { // // Possible values: // "REASON_UNSPECIFIED" - Reason unspecified. - // "GOAL_IMPOSSIBLE" - The goal was impossible to accomplish. + // "GOAL_IMPOSSIBLE" - The goal failed to be completed. Note that + // "impossible" is a legacy term and the goal is reported to the customer as + // having "failed". // "GOAL_COMPLETE" - The goal was completed successfully. Reason string `json:"reason,omitempty"` // Screenshot: Output only. The screenshot used in the context of this terminal diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index cb9568a831..427027d3af 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20250309", + "revision": "20250312", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -1085,6 +1085,10 @@ "description": "Chunk from the web.", "id": "GoogleCloudAiplatformV1beta1GroundingChunkWeb", "properties": { + "domain": { + "description": "Domain of the (original) URI.", + "type": "string" + }, "title": { "description": "Title of the chunk.", "type": "string" diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index a975a94c99..e331591b2c 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -1247,17 +1247,19 @@ func (s GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext) MarshalJSON( // GoogleCloudAiplatformV1beta1GroundingChunkWeb: Chunk from the web. type GoogleCloudAiplatformV1beta1GroundingChunkWeb struct { + // Domain: Domain of the (original) URI. + Domain string `json:"domain,omitempty"` // Title: Title of the chunk. Title string `json:"title,omitempty"` // Uri: URI reference of the chunk. Uri string `json:"uri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Title") to unconditionally + // ForceSendFields is a list of field names (e.g. "Domain") 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. "Title") to include in API + // NullFields is a list of field names (e.g. "Domain") 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. diff --git a/gkebackup/v1/gkebackup-api.json b/gkebackup/v1/gkebackup-api.json index c730b0628c..a16a2cfbec 100644 --- a/gkebackup/v1/gkebackup-api.json +++ b/gkebackup/v1/gkebackup-api.json @@ -623,6 +623,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field will be populated.", + "location": "query", + "type": "boolean" } }, "path": "v1/{+parent}/backups", @@ -1713,7 +1718,7 @@ } } }, - "revision": "20250226", + "revision": "20250305", "rootUrl": "https://gkebackup.googleapis.com/", "schemas": { "AuditConfig": { @@ -1876,6 +1881,16 @@ "readOnly": true, "type": "string" }, + "satisfiesPzi": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "selectedApplications": { "$ref": "NamespacedNames", "description": "Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.", @@ -2485,6 +2500,13 @@ "nextPageToken": { "description": "A token which may be sent as page_token in a subsequent `ListBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -3402,6 +3424,16 @@ "readOnly": true, "type": "string" }, + "satisfiesPzi": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "sourcePvc": { "$ref": "NamespacedName", "description": "Output only. A reference to the source Kubernetes PVC from which this VolumeBackup was created.", diff --git a/gkebackup/v1/gkebackup-gen.go b/gkebackup/v1/gkebackup-gen.go index 52c4c60954..727b6cebb8 100644 --- a/gkebackup/v1/gkebackup-gen.go +++ b/gkebackup/v1/gkebackup-gen.go @@ -418,6 +418,10 @@ type Backup struct { // RetainExpireTime: Output only. The time at which this Backup will be // automatically deleted (calculated from create_time + retain_days). RetainExpireTime string `json:"retainExpireTime,omitempty"` + // SatisfiesPzi: Output only. [Output Only] Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. [Output Only] Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // SelectedApplications: Output only. If set, the list of ProtectedApplications // whose resources were included in the Backup. SelectedApplications *NamespacedNames `json:"selectedApplications,omitempty"` @@ -1264,6 +1268,8 @@ type ListBackupsResponse struct { // `ListBackups` call to retrieve the next page of results. If this field is // omitted or empty, then there are no more results to return. NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2522,6 +2528,10 @@ type VolumeBackup struct { // Name: Output only. The full name of the VolumeBackup resource. Format: // `projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*`. Name string `json:"name,omitempty"` + // SatisfiesPzi: Output only. [Output Only] Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. [Output Only] Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // SourcePvc: Output only. A reference to the source Kubernetes PVC from which // this VolumeBackup was created. SourcePvc *NamespacedName `json:"sourcePvc,omitempty"` @@ -4613,6 +4623,14 @@ func (c *ProjectsLocationsBackupPlansBackupsListCall) PageToken(pageToken string return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field will be populated. +func (c *ProjectsLocationsBackupPlansBackupsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsBackupPlansBackupsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + 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/go.mod b/go.mod index 6595184783..a200c5393c 100644 --- a/go.mod +++ b/go.mod @@ -9,7 +9,7 @@ require ( github.com/google/go-cmp v0.7.0 github.com/google/s2a-go v0.1.9 github.com/google/uuid v1.6.0 - github.com/googleapis/enterprise-certificate-proxy v0.3.5 + github.com/googleapis/enterprise-certificate-proxy v0.3.6 github.com/googleapis/gax-go/v2 v2.14.1 go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.59.0 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.59.0 @@ -17,8 +17,8 @@ require ( golang.org/x/oauth2 v0.28.0 golang.org/x/sync v0.12.0 golang.org/x/time v0.11.0 - google.golang.org/genproto/googleapis/bytestream v0.0.0-20250303144028-a0af3efb3deb - google.golang.org/genproto/googleapis/rpc v0.0.0-20250303144028-a0af3efb3deb + google.golang.org/genproto/googleapis/bytestream v0.0.0-20250313205543-e70fdf4c4cb4 + google.golang.org/genproto/googleapis/rpc v0.0.0-20250313205543-e70fdf4c4cb4 google.golang.org/grpc v1.71.0 google.golang.org/protobuf v1.36.5 ) diff --git a/go.sum b/go.sum index eefd8d8a0d..f25764a848 100644 --- a/go.sum +++ b/go.sum @@ -21,8 +21,8 @@ github.com/google/s2a-go v0.1.9 h1:LGD7gtMgezd8a/Xak7mEWL0PjoTQFvpRudN895yqKW0= github.com/google/s2a-go v0.1.9/go.mod h1:YA0Ei2ZQL3acow2O62kdp9UlnvMmU7kA6Eutn0dXayM= github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= -github.com/googleapis/enterprise-certificate-proxy v0.3.5 h1:VgzTY2jogw3xt39CusEnFJWm7rlsq5yL5q9XdLOuP5g= -github.com/googleapis/enterprise-certificate-proxy v0.3.5/go.mod h1:MkHOF77EYAE7qfSuSS9PU6g4Nt4e11cnsDUowfwewLA= +github.com/googleapis/enterprise-certificate-proxy v0.3.6 h1:GW/XbdyBFQ8Qe+YAmFU9uHLo7OnF5tL52HFAgMmyrf4= +github.com/googleapis/enterprise-certificate-proxy v0.3.6/go.mod h1:MkHOF77EYAE7qfSuSS9PU6g4Nt4e11cnsDUowfwewLA= github.com/googleapis/gax-go/v2 v2.14.1 h1:hb0FFeiPaQskmvakKu5EbCbpntQn48jyHuvrkurSS/Q= github.com/googleapis/gax-go/v2 v2.14.1/go.mod h1:Hb/NubMaVM88SrNkvl8X/o8XWwDJEPqouaLeN2IUxoA= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= @@ -61,10 +61,10 @@ golang.org/x/time v0.11.0 h1:/bpjEDfN9tkoN/ryeYHnv5hcMlc8ncjMcM4XBk5NWV0= golang.org/x/time v0.11.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg= google.golang.org/genproto/googleapis/api v0.0.0-20250106144421-5f5ef82da422 h1:GVIKPyP/kLIyVOgOnTwFOrvQaQUzOzGMCxgFUOEmm24= google.golang.org/genproto/googleapis/api v0.0.0-20250106144421-5f5ef82da422/go.mod h1:b6h1vNKhxaSoEI+5jc3PJUCustfli/mRab7295pY7rw= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20250303144028-a0af3efb3deb h1:kw/Q892zrnljh8PXAIHmsCXgpxtSyWL4oV1eRnFtdeg= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20250303144028-a0af3efb3deb/go.mod h1:35wIojE/F1ptq1nfNDNjtowabHoMSA2qQs7+smpCO5s= -google.golang.org/genproto/googleapis/rpc v0.0.0-20250303144028-a0af3efb3deb h1:TLPQVbx1GJ8VKZxz52VAxl1EBgKXXbTiU9Fc5fZeLn4= -google.golang.org/genproto/googleapis/rpc v0.0.0-20250303144028-a0af3efb3deb/go.mod h1:LuRYeWDFV6WOn90g357N17oMCaxpgCnbi/44qJvDn2I= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20250313205543-e70fdf4c4cb4 h1:WYmu3W5hpq5LblAdrydghP6bWFowtV6EYG+RCT0lok4= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20250313205543-e70fdf4c4cb4/go.mod h1:WkJpQl6Ujj3ElX4qZaNm5t6cT95ffI4K+HKQ0+1NyMw= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250313205543-e70fdf4c4cb4 h1:iK2jbkWL86DXjEx0qiHcRE9dE4/Ahua5k6V8OWFb//c= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250313205543-e70fdf4c4cb4/go.mod h1:LuRYeWDFV6WOn90g357N17oMCaxpgCnbi/44qJvDn2I= google.golang.org/grpc v1.71.0 h1:kF77BGdPTQ4/JZWMlb9VpJ5pa25aqvVqogsxNHHdeBg= google.golang.org/grpc v1.71.0/go.mod h1:H0GRtasmQOh9LkFoCPDu3ZrwUtD1YGE+b2vYBYd/8Ec= google.golang.org/protobuf v1.36.5 h1:tPhr+woSbjfYvY6/GPufUoYizxw1cF/yFoxJ2fmpwlM= diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index bdf04818f3..205f73b935 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -6011,7 +6011,7 @@ } } }, - "revision": "20250219", + "revision": "20250306", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -8494,6 +8494,10 @@ "description": "The BigQuery table where the server writes output.", "id": "GoogleCloudHealthcareV1beta1DicomBigQueryDestination", "properties": { + "changeDataCaptureConfig": { + "$ref": "GoogleCloudHealthcareV1beta1DicomChangeDataCaptureConfig", + "description": "Optional. Setting this field will enable BigQuery's Change Data Capture (CDC) on the destination tables. Set this field if you want to only keep the latest version of each instance. Updates and deletes to an existing' instance will overwrite the corresponding row. See https://cloud.google.com/bigquery/docs/change-data-capture for details." + }, "force": { "description": "Use `write_disposition` instead. If `write_disposition` is specified, this parameter is ignored. force=false is equivalent to write_disposition=WRITE_EMPTY and force=true is equivalent to write_disposition=WRITE_TRUNCATE.", "type": "boolean" @@ -8521,6 +8525,12 @@ }, "type": "object" }, + "GoogleCloudHealthcareV1beta1DicomChangeDataCaptureConfig": { + "description": "BigQuery Change Data Capture configuration.", + "id": "GoogleCloudHealthcareV1beta1DicomChangeDataCaptureConfig", + "properties": {}, + "type": "object" + }, "GoogleCloudHealthcareV1beta1DicomGcsDestination": { "description": "The Cloud Storage location where the server writes the output and the export configuration.", "id": "GoogleCloudHealthcareV1beta1DicomGcsDestination", diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index b4d6f91210..7062ffeeb8 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -4324,6 +4324,12 @@ func (s GoogleCloudHealthcareV1beta1DeidentifyOptions) MarshalJSON() ([]byte, er // GoogleCloudHealthcareV1beta1DicomBigQueryDestination: The BigQuery table // where the server writes output. type GoogleCloudHealthcareV1beta1DicomBigQueryDestination struct { + // ChangeDataCaptureConfig: Optional. Setting this field will enable BigQuery's + // Change Data Capture (CDC) on the destination tables. Set this field if you + // want to only keep the latest version of each instance. Updates and deletes + // to an existing' instance will overwrite the corresponding row. See + // https://cloud.google.com/bigquery/docs/change-data-capture for details. + ChangeDataCaptureConfig *GoogleCloudHealthcareV1beta1DicomChangeDataCaptureConfig `json:"changeDataCaptureConfig,omitempty"` // Force: Use `write_disposition` instead. If `write_disposition` is specified, // this parameter is ignored. force=false is equivalent to // write_disposition=WRITE_EMPTY and force=true is equivalent to @@ -4344,15 +4350,15 @@ type GoogleCloudHealthcareV1beta1DicomBigQueryDestination struct { // writing the instances. // "WRITE_APPEND" - Append data to the destination table. WriteDisposition string `json:"writeDisposition,omitempty"` - // ForceSendFields is a list of field names (e.g. "Force") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "ChangeDataCaptureConfig") 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. "Force") 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. "ChangeDataCaptureConfig") 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:"-"` } @@ -4362,6 +4368,11 @@ func (s GoogleCloudHealthcareV1beta1DicomBigQueryDestination) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudHealthcareV1beta1DicomChangeDataCaptureConfig: BigQuery Change +// Data Capture configuration. +type GoogleCloudHealthcareV1beta1DicomChangeDataCaptureConfig struct { +} + // GoogleCloudHealthcareV1beta1DicomGcsDestination: The Cloud Storage location // where the server writes the output and the export configuration. type GoogleCloudHealthcareV1beta1DicomGcsDestination struct { diff --git a/internal/version.go b/internal/version.go index f95f9aed81..c56e90df16 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.226.0" +const Version = "0.227.0" diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index 006e099879..e78a8cab9a 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -8922,9 +8922,85 @@ } } }, - "revision": "20250207", + "revision": "20250307", "rootUrl": "https://logging.googleapis.com/", "schemas": { + "AppHub": { + "description": "Metadata associated with App Hub.", + "id": "AppHub", + "properties": { + "application": { + "$ref": "AppHubApplication", + "description": "Metadata associated with the application." + }, + "service": { + "$ref": "AppHubService", + "description": "Metadata associated with the service." + }, + "workload": { + "$ref": "AppHubWorkload", + "description": "Metadata associated with the workload." + } + }, + "type": "object" + }, + "AppHubApplication": { + "description": "Resource identifiers associated with an AppHub application AppHub resources are of the form projects//locations//applications/ projects//locations//applications//services/ projects//locations//applications//workloads/ These resources can be reconstructed from the components below.", + "id": "AppHubApplication", + "properties": { + "container": { + "description": "Resource container that owns the application. Example: \"projects/management_project\"", + "type": "string" + }, + "id": { + "description": "Application Id. Example: \"my-app\"", + "type": "string" + }, + "location": { + "description": "Location associated with the Application. Example: \"us-east1\"", + "type": "string" + } + }, + "type": "object" + }, + "AppHubService": { + "description": "Metadata associated with an App Hub service.", + "id": "AppHubService", + "properties": { + "criticalityType": { + "description": "Service criticality type Example: \"CRITICAL\"", + "type": "string" + }, + "environmentType": { + "description": "Service environment type Example: \"DEV\"", + "type": "string" + }, + "id": { + "description": "Service Id. Example: \"my-service\"", + "type": "string" + } + }, + "type": "object" + }, + "AppHubWorkload": { + "description": "Metadata associated with an App Hub workload.", + "id": "AppHubWorkload", + "properties": { + "criticalityType": { + "description": "Workload criticality type Example: \"CRITICAL\"", + "type": "string" + }, + "environmentType": { + "description": "Workload environment type Example: \"DEV\"", + "type": "string" + }, + "id": { + "description": "Workload Id. Example: \"my-workload\"", + "type": "string" + } + }, + "type": "object" + }, "BigQueryDataset": { "description": "Describes a BigQuery dataset that was created by a link.", "id": "BigQueryDataset", @@ -10034,6 +10110,11 @@ "description": "An individual entry in a log.", "id": "LogEntry", "properties": { + "apphub": { + "$ref": "AppHub", + "description": "Output only. AppHub application metadata associated with this LogEntry. May be empty if there is no associated AppHub application or multiple associated applications (such as for VPC flow logs)", + "readOnly": true + }, "errorGroups": { "description": "Output only. The Error Reporting (https://cloud.google.com/error-reporting) error groups associated with this LogEntry. Error Reporting sets the values for this field during error group creation.For more information, see View error details( https://cloud.google.com/error-reporting/docs/viewing-errors#view_error_details)This field isn't available during log routing (https://cloud.google.com/logging/docs/routing/overview)", "items": { diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index 7ac5588c97..af75a7b8a6 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -934,6 +934,116 @@ type V2Service struct { s *Service } +// AppHub: Metadata associated with App Hub. +type AppHub struct { + // Application: Metadata associated with the application. + Application *AppHubApplication `json:"application,omitempty"` + // Service: Metadata associated with the service. + Service *AppHubService `json:"service,omitempty"` + // Workload: Metadata associated with the workload. + Workload *AppHubWorkload `json:"workload,omitempty"` + // ForceSendFields is a list of field names (e.g. "Application") 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. "Application") 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 AppHub) MarshalJSON() ([]byte, error) { + type NoMethod AppHub + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AppHubApplication: Resource identifiers associated with an AppHub +// application AppHub resources are of the form +// projects//locations//applications/ +// projects//locations//applications//services/ +// projects//locations//applications//workloads/ These resources can be +// reconstructed from the components below. +type AppHubApplication struct { + // Container: Resource container that owns the application. Example: + // "projects/management_project" + Container string `json:"container,omitempty"` + // Id: Application Id. Example: "my-app" + Id string `json:"id,omitempty"` + // Location: Location associated with the Application. Example: "us-east1" + Location string `json:"location,omitempty"` + // ForceSendFields is a list of field names (e.g. "Container") 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. "Container") 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 AppHubApplication) MarshalJSON() ([]byte, error) { + type NoMethod AppHubApplication + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AppHubService: Metadata associated with an App Hub service. +type AppHubService struct { + // CriticalityType: Service criticality type Example: "CRITICAL" + CriticalityType string `json:"criticalityType,omitempty"` + // EnvironmentType: Service environment type Example: "DEV" + EnvironmentType string `json:"environmentType,omitempty"` + // Id: Service Id. Example: "my-service" + Id string `json:"id,omitempty"` + // ForceSendFields is a list of field names (e.g. "CriticalityType") 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. "CriticalityType") 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 AppHubService) MarshalJSON() ([]byte, error) { + type NoMethod AppHubService + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AppHubWorkload: Metadata associated with an App Hub workload. +type AppHubWorkload struct { + // CriticalityType: Workload criticality type Example: "CRITICAL" + CriticalityType string `json:"criticalityType,omitempty"` + // EnvironmentType: Workload environment type Example: "DEV" + EnvironmentType string `json:"environmentType,omitempty"` + // Id: Workload Id. Example: "my-workload" + Id string `json:"id,omitempty"` + // ForceSendFields is a list of field names (e.g. "CriticalityType") 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. "CriticalityType") 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 AppHubWorkload) MarshalJSON() ([]byte, error) { + type NoMethod AppHubWorkload + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BigQueryDataset: Describes a BigQuery dataset that was created by a link. type BigQueryDataset struct { // DatasetId: Output only. The full resource name of the BigQuery dataset. The @@ -2641,6 +2751,10 @@ func (s LogBucket) MarshalJSON() ([]byte, error) { // LogEntry: An individual entry in a log. type LogEntry struct { + // Apphub: Output only. AppHub application metadata associated with this + // LogEntry. May be empty if there is no associated AppHub application or + // multiple associated applications (such as for VPC flow logs) + Apphub *AppHub `json:"apphub,omitempty"` // ErrorGroups: Output only. The Error Reporting // (https://cloud.google.com/error-reporting) error groups associated with this // LogEntry. Error Reporting sets the values for this field during error group @@ -2782,13 +2896,13 @@ type LogEntry struct { // value is still useful as a request correlation identifier. The default is // False. TraceSampled bool `json:"traceSampled,omitempty"` - // ForceSendFields is a list of field names (e.g. "ErrorGroups") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Apphub") 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. "ErrorGroups") to include in API + // NullFields is a list of field names (e.g. "Apphub") 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. diff --git a/looker/v1/looker-api.json b/looker/v1/looker-api.json index 86c0028fe2..b761fc417a 100644 --- a/looker/v1/looker-api.json +++ b/looker/v1/looker-api.json @@ -420,159 +420,6 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] - }, - "restore": { - "description": "Restore Looker instance.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:restore", - "httpMethod": "POST", - "id": "looker.projects.locations.instances.restore", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Instance being restored Format: projects/{project}/locations/{location}/instances/{instance}", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}:restore", - "request": { - "$ref": "RestoreInstanceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - }, - "resources": { - "backups": { - "methods": { - "create": { - "description": "Backup Looker instance.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups", - "httpMethod": "POST", - "id": "looker.projects.locations.instances.backups.create", - "parameterOrder": [ - "parent" - ], - "parameters": { - "parent": { - "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+parent}/backups", - "request": { - "$ref": "InstanceBackup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "delete": { - "description": "Delete backup.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups/{backupsId}", - "httpMethod": "DELETE", - "id": "looker.projects.locations.instances.backups.delete", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}/backups/{backup}", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+/backups/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "get": { - "description": "", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups/{backupsId}", - "httpMethod": "GET", - "id": "looker.projects.locations.instances.backups.get", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}/backups/{backup}`.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+/backups/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "InstanceBackup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "list": { - "description": "List backups of Looker instance.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups", - "httpMethod": "GET", - "id": "looker.projects.locations.instances.backups.list", - "parameterOrder": [ - "parent" - ], - "parameters": { - "orderBy": { - "description": "Sort results. Default order is \"create_time desc\". Other supported fields are \"state\" and \"expire_time\". https://google.aip.dev/132#ordering", - "location": "query", - "type": "string" - }, - "pageSize": { - "description": "The maximum number of instances to return.", - "format": "int32", - "location": "query", - "type": "integer" - }, - "pageToken": { - "description": "A page token received from a previous ListInstances request.", - "location": "query", - "type": "string" - }, - "parent": { - "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+parent}/backups", - "response": { - "$ref": "ListInstanceBackupsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } } } }, @@ -704,7 +551,7 @@ } } }, - "revision": "20250205", + "revision": "20250305", "rootUrl": "https://looker.googleapis.com/", "schemas": { "AdminSettings": { @@ -1124,78 +971,6 @@ }, "type": "object" }, - "InstanceBackup": { - "description": "The details of a backup resource.", - "id": "InstanceBackup", - "properties": { - "createTime": { - "description": "Output only. The time when the backup was started.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "encryptionConfig": { - "$ref": "EncryptionConfig", - "description": "Output only. Current status of the CMEK encryption", - "readOnly": true - }, - "expireTime": { - "description": "Output only. The time when the backup will be deleted.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "name": { - "description": "Immutable. The relative resource name of the backup, in the following form: `projects/{project_number}/locations/{location_id}/instances/{instance_id}/backups/{backup}`", - "type": "string" - }, - "state": { - "description": "Output only. The current state of the backup.", - "enum": [ - "STATE_UNSPECIFIED", - "CREATING", - "DELETING", - "ACTIVE", - "FAILED" - ], - "enumDescriptions": [ - "The state of the backup is unknown.", - "The backup is being created.", - "The backup is being deleted.", - "The backup is active and ready to use.", - "The backup failed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "ListInstanceBackupsResponse": { - "description": "Response from listing Looker instance backups.", - "id": "ListInstanceBackupsResponse", - "properties": { - "instanceBackups": { - "description": "The list of instances matching the request filters, up to the requested `page_size`.", - "items": { - "$ref": "InstanceBackup" - }, - "type": "array" - }, - "nextPageToken": { - "description": "If provided, a page token that can look up the next `page_size` results. If empty, the results list is exhausted.", - "type": "string" - }, - "unreachable": { - "description": "Locations that could not be reached.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ListInstancesResponse": { "description": "Response from ListInstances.", "id": "ListInstancesResponse", @@ -1462,17 +1237,6 @@ "properties": {}, "type": "object" }, - "RestoreInstanceRequest": { - "description": "Request options for restoring an instance", - "id": "RestoreInstanceRequest", - "properties": { - "backup": { - "description": "Required. Backup being used to restore the instance Format: projects/{project}/locations/{location}/instances/{instance}/backups/{backup}", - "type": "string" - } - }, - "type": "object" - }, "ServiceAttachment": { "description": "Service attachment configuration.", "id": "ServiceAttachment", diff --git a/looker/v1/looker-gen.go b/looker/v1/looker-gen.go index 3a22aed75b..1ccf4404da 100644 --- a/looker/v1/looker-gen.go +++ b/looker/v1/looker-gen.go @@ -186,23 +186,11 @@ type ProjectsLocationsService struct { func NewProjectsLocationsInstancesService(s *Service) *ProjectsLocationsInstancesService { rs := &ProjectsLocationsInstancesService{s: s} - rs.Backups = NewProjectsLocationsInstancesBackupsService(s) return rs } type ProjectsLocationsInstancesService struct { s *Service - - Backups *ProjectsLocationsInstancesBackupsService -} - -func NewProjectsLocationsInstancesBackupsService(s *Service) *ProjectsLocationsInstancesBackupsService { - rs := &ProjectsLocationsInstancesBackupsService{s: s} - return rs -} - -type ProjectsLocationsInstancesBackupsService struct { - s *Service } func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { @@ -643,80 +631,6 @@ func (s Instance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InstanceBackup: The details of a backup resource. -type InstanceBackup struct { - // CreateTime: Output only. The time when the backup was started. - CreateTime string `json:"createTime,omitempty"` - // EncryptionConfig: Output only. Current status of the CMEK encryption - EncryptionConfig *EncryptionConfig `json:"encryptionConfig,omitempty"` - // ExpireTime: Output only. The time when the backup will be deleted. - ExpireTime string `json:"expireTime,omitempty"` - // Name: Immutable. The relative resource name of the backup, in the following - // form: - // `projects/{project_number}/locations/{location_id}/instances/{instance_id}/ba - // ckups/{backup}` - Name string `json:"name,omitempty"` - // State: Output only. The current state of the backup. - // - // Possible values: - // "STATE_UNSPECIFIED" - The state of the backup is unknown. - // "CREATING" - The backup is being created. - // "DELETING" - The backup is being deleted. - // "ACTIVE" - The backup is active and ready to use. - // "FAILED" - The backup failed. - State string `json:"state,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 InstanceBackup) MarshalJSON() ([]byte, error) { - type NoMethod InstanceBackup - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// ListInstanceBackupsResponse: Response from listing Looker instance backups. -type ListInstanceBackupsResponse struct { - // InstanceBackups: The list of instances matching the request filters, up to - // the requested `page_size`. - InstanceBackups []*InstanceBackup `json:"instanceBackups,omitempty"` - // NextPageToken: If provided, a page token that can look up the next - // `page_size` results. If empty, the results list is exhausted. - NextPageToken string `json:"nextPageToken,omitempty"` - // Unreachable: Locations that could not be reached. - Unreachable []string `json:"unreachable,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "InstanceBackups") 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. "InstanceBackups") 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 ListInstanceBackupsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListInstanceBackupsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListInstancesResponse: Response from ListInstances. type ListInstancesResponse struct { // Instances: The list of instances matching the request filters, up to the @@ -1046,29 +960,6 @@ func (s PscConfig) MarshalJSON() ([]byte, error) { type RestartInstanceRequest struct { } -// RestoreInstanceRequest: Request options for restoring an instance -type RestoreInstanceRequest struct { - // Backup: Required. Backup being used to restore the instance Format: - // projects/{project}/locations/{location}/instances/{instance}/backups/{backup} - Backup string `json:"backup,omitempty"` - // ForceSendFields is a list of field names (e.g. "Backup") 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. "Backup") 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 RestoreInstanceRequest) MarshalJSON() ([]byte, error) { - type NoMethod RestoreInstanceRequest - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ServiceAttachment: Service attachment configuration. type ServiceAttachment struct { // ConnectionStatus: Output only. Connection status. @@ -2371,578 +2262,6 @@ func (c *ProjectsLocationsInstancesRestartCall) Do(opts ...googleapi.CallOption) return ret, nil } -type ProjectsLocationsInstancesRestoreCall struct { - s *Service - name string - restoreinstancerequest *RestoreInstanceRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Restore: Restore Looker instance. -// -// - name: Instance being restored Format: -// projects/{project}/locations/{location}/instances/{instance}. -func (r *ProjectsLocationsInstancesService) Restore(name string, restoreinstancerequest *RestoreInstanceRequest) *ProjectsLocationsInstancesRestoreCall { - c := &ProjectsLocationsInstancesRestoreCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.restoreinstancerequest = restoreinstancerequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsInstancesRestoreCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesRestoreCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInstancesRestoreCall) Context(ctx context.Context) *ProjectsLocationsInstancesRestoreCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsInstancesRestoreCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInstancesRestoreCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.restoreinstancerequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:restore") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.restore", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "looker.projects.locations.instances.restore" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsInstancesRestoreCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.restore", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsInstancesBackupsCreateCall struct { - s *Service - parent string - instancebackup *InstanceBackup - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Create: Backup Looker instance. -// -// - parent: Format: -// projects/{project}/locations/{location}/instances/{instance}. -func (r *ProjectsLocationsInstancesBackupsService) Create(parent string, instancebackup *InstanceBackup) *ProjectsLocationsInstancesBackupsCreateCall { - c := &ProjectsLocationsInstancesBackupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.instancebackup = instancebackup - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsInstancesBackupsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesBackupsCreateCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInstancesBackupsCreateCall) Context(ctx context.Context) *ProjectsLocationsInstancesBackupsCreateCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsInstancesBackupsCreateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInstancesBackupsCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.instancebackup) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backups") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.create", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "looker.projects.locations.instances.backups.create" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsInstancesBackupsCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.create", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsInstancesBackupsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: Delete backup. -// -// - name: Format: -// projects/{project}/locations/{location}/instances/{instance}/backups/{backu -// p}. -func (r *ProjectsLocationsInstancesBackupsService) Delete(name string) *ProjectsLocationsInstancesBackupsDeleteCall { - c := &ProjectsLocationsInstancesBackupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsInstancesBackupsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesBackupsDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInstancesBackupsDeleteCall) Context(ctx context.Context) *ProjectsLocationsInstancesBackupsDeleteCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsInstancesBackupsDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInstancesBackupsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "looker.projects.locations.instances.backups.delete" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsInstancesBackupsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsInstancesBackupsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: -// -// - name: Format: -// `projects/{project}/locations/{location}/instances/{instance}/backups/{back -// up}`. -func (r *ProjectsLocationsInstancesBackupsService) Get(name string) *ProjectsLocationsInstancesBackupsGetCall { - c := &ProjectsLocationsInstancesBackupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsInstancesBackupsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesBackupsGetCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsInstancesBackupsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsInstancesBackupsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInstancesBackupsGetCall) Context(ctx context.Context) *ProjectsLocationsInstancesBackupsGetCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsInstancesBackupsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInstancesBackupsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "looker.projects.locations.instances.backups.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *InstanceBackup.ServerResponse.Header or (if a response was returned at all) -// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsInstancesBackupsGetCall) Do(opts ...googleapi.CallOption) (*InstanceBackup, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &InstanceBackup{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsInstancesBackupsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: List backups of Looker instance. -// -// - parent: Format: -// projects/{project}/locations/{location}/instances/{instance}. -func (r *ProjectsLocationsInstancesBackupsService) List(parent string) *ProjectsLocationsInstancesBackupsListCall { - c := &ProjectsLocationsInstancesBackupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// OrderBy sets the optional parameter "orderBy": Sort results. Default order -// is "create_time desc". Other supported fields are "state" and "expire_time". -// https://google.aip.dev/132#ordering -func (c *ProjectsLocationsInstancesBackupsListCall) OrderBy(orderBy string) *ProjectsLocationsInstancesBackupsListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": The maximum number of -// instances to return. -func (c *ProjectsLocationsInstancesBackupsListCall) PageSize(pageSize int64) *ProjectsLocationsInstancesBackupsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": A page token received -// from a previous ListInstances request. -func (c *ProjectsLocationsInstancesBackupsListCall) PageToken(pageToken string) *ProjectsLocationsInstancesBackupsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsInstancesBackupsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesBackupsListCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsInstancesBackupsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsInstancesBackupsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInstancesBackupsListCall) Context(ctx context.Context) *ProjectsLocationsInstancesBackupsListCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsInstancesBackupsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInstancesBackupsListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backups") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "looker.projects.locations.instances.backups.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListInstanceBackupsResponse.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsInstancesBackupsListCall) Do(opts ...googleapi.CallOption) (*ListInstanceBackupsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &ListInstanceBackupsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "looker.projects.locations.instances.backups.list", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsInstancesBackupsListCall) Pages(ctx context.Context, f func(*ListInstanceBackupsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - type ProjectsLocationsOperationsCancelCall struct { s *Service name string diff --git a/managedkafka/v1/managedkafka-api.json b/managedkafka/v1/managedkafka-api.json new file mode 100644 index 0000000000..1cbec11182 --- /dev/null +++ b/managedkafka/v1/managedkafka-api.json @@ -0,0 +1,1253 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://managedkafka.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Managed Kafka", + "description": "Manage Apache Kafka clusters and resources. ", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/managed-service-for-apache-kafka/docs", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "managedkafka:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://managedkafka.mtls.googleapis.com/", + "name": "managedkafka", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service.", + "flatPath": "v1/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "location": "query", + "type": "string" + }, + "name": { + "description": "The resource that owns the locations collection, if applicable.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The maximum number of results to return. If not set, the service selects a default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "clusters": { + "methods": { + "create": { + "description": "Creates a new cluster in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters", + "httpMethod": "POST", + "id": "managedkafka.projects.locations.clusters.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "clusterId": { + "description": "Required. The ID to use for the cluster, which will become the final component of the cluster's name. The ID must be 1-63 characters long, and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` to comply with RFC 1035. This value is structured like: `my-cluster-id`.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent region in which to create the cluster. Structured like `projects/{project}/locations/{location}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID to avoid duplication of requests. If a request times out or fails, retrying with the same ID allows the server to recognize the previous attempt. For at least 60 minutes, the server ignores duplicate requests bearing the same ID. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID within 60 minutes of the last request, the server checks if an original operation with the same request ID was received. If so, the server ignores the second request. The request ID must be a valid UUID. A zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/clusters", + "request": { + "$ref": "Cluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}", + "httpMethod": "DELETE", + "id": "managedkafka.projects.locations.clusters.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the cluster to delete.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID to avoid duplication of requests. If a request times out or fails, retrying with the same ID allows the server to recognize the previous attempt. For at least 60 minutes, the server ignores duplicate requests bearing the same ID. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID within 60 minutes of the last request, the server checks if an original operation with the same request ID was received. If so, the server ignores the second request. The request ID must be a valid UUID. A zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Returns the properties of a single cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.clusters.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the cluster whose configuration to return.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Cluster" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the clusters in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.clusters.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filter expression for the result.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Order by fields for the result.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of clusters to return. The service may return fewer than this value. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListClusters` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListClusters` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent location whose clusters are to be listed. Structured like `projects/{project}/locations/{location}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/clusters", + "response": { + "$ref": "ListClustersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the properties of a single cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}", + "httpMethod": "PATCH", + "id": "managedkafka.projects.locations.clusters.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The name of the cluster. Structured like: projects/{project_number}/locations/{location}/clusters/{cluster_id}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID to avoid duplication of requests. If a request times out or fails, retrying with the same ID allows the server to recognize the previous attempt. For at least 60 minutes, the server ignores duplicate requests bearing the same ID. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID within 60 minutes of the last request, the server checks if an original operation with the same request ID was received. If so, the server ignores the second request. The request ID must be a valid UUID. A zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the cluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. The mask is required and a value of * will update all fields.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Cluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "consumerGroups": { + "methods": { + "delete": { + "description": "Deletes a single consumer group.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/consumerGroups/{consumerGroupsId}", + "httpMethod": "DELETE", + "id": "managedkafka.projects.locations.clusters.consumerGroups.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the consumer group to delete. `projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/{consumerGroup}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/consumerGroups/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Returns the properties of a single consumer group.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/consumerGroups/{consumerGroupsId}", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.clusters.consumerGroups.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the consumer group whose configuration to return. `projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/{consumerGroup}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/consumerGroups/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "ConsumerGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the consumer groups in a given cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/consumerGroups", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.clusters.consumerGroups.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of consumer groups to return. The service may return fewer than this value. If unset or zero, all consumer groups for the parent is returned.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListConsumerGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListConsumerGroups` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent cluster whose consumer groups are to be listed. Structured like `projects/{project}/locations/{location}/clusters/{cluster}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/consumerGroups", + "response": { + "$ref": "ListConsumerGroupsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the properties of a single consumer group.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/consumerGroups/{consumerGroupsId}", + "httpMethod": "PATCH", + "id": "managedkafka.projects.locations.clusters.consumerGroups.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The name of the consumer group. The `consumer_group` segment is used when connecting directly to the cluster. Structured like: projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/{consumer_group}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/consumerGroups/.*$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the ConsumerGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. The mask is required and a value of * will update all fields.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "ConsumerGroup" + }, + "response": { + "$ref": "ConsumerGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "topics": { + "methods": { + "create": { + "description": "Creates a new topic in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/topics", + "httpMethod": "POST", + "id": "managedkafka.projects.locations.clusters.topics.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent cluster in which to create the topic. Structured like `projects/{project}/locations/{location}/clusters/{cluster}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + }, + "topicId": { + "description": "Required. The ID to use for the topic, which will become the final component of the topic's name. This value is structured like: `my-topic-name`.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/topics", + "request": { + "$ref": "Topic" + }, + "response": { + "$ref": "Topic" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single topic.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/topics/{topicsId}", + "httpMethod": "DELETE", + "id": "managedkafka.projects.locations.clusters.topics.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the topic to delete. `projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/topics/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Returns the properties of a single topic.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/topics/{topicsId}", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.clusters.topics.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the topic whose configuration to return. Structured like: projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/topics/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Topic" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the topics in a given cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/topics", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.clusters.topics.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of topics to return. The service may return fewer than this value. If unset or zero, all topics for the parent is returned.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListTopics` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTopics` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent cluster whose topics are to be listed. Structured like `projects/{project}/locations/{location}/clusters/{cluster}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/topics", + "response": { + "$ref": "ListTopicsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the properties of a single topic.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/topics/{topicsId}", + "httpMethod": "PATCH", + "id": "managedkafka.projects.locations.clusters.topics.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The name of the topic. The `topic` segment is used when connecting directly to the cluster. Structured like: projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/topics/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the Topic resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. The mask is required and a value of * will update all fields.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Topic" + }, + "response": { + "$ref": "Topic" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "managedkafka.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "managedkafka.projects.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "managedkafka.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + }, + "revision": "20250306", + "rootUrl": "https://managedkafka.googleapis.com/", + "schemas": { + "AccessConfig": { + "description": "The configuration of access to the Kafka cluster.", + "id": "AccessConfig", + "properties": { + "networkConfigs": { + "description": "Required. Virtual Private Cloud (VPC) networks that must be granted direct access to the Kafka cluster. Minimum of 1 network is required. Maximum 10 networks can be specified.", + "items": { + "$ref": "NetworkConfig" + }, + "type": "array" + } + }, + "type": "object" + }, + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "type": "object" + }, + "CapacityConfig": { + "description": "A capacity configuration of a Kafka cluster.", + "id": "CapacityConfig", + "properties": { + "memoryBytes": { + "description": "Required. The memory to provision for the cluster in bytes. The CPU:memory ratio (vCPU:GiB) must be between 1:1 and 1:8. Minimum: 3221225472 (3 GiB).", + "format": "int64", + "type": "string" + }, + "vcpuCount": { + "description": "Required. The number of vCPUs to provision for the cluster. Minimum: 3.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "Cluster": { + "description": "An Apache Kafka cluster deployed in a location.", + "id": "Cluster", + "properties": { + "capacityConfig": { + "$ref": "CapacityConfig", + "description": "Required. Capacity configuration for the Kafka cluster." + }, + "createTime": { + "description": "Output only. The time when the cluster was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "gcpConfig": { + "$ref": "GcpConfig", + "description": "Required. Configuration properties for a Kafka cluster deployed to Google Cloud Platform." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs.", + "type": "object" + }, + "name": { + "description": "Identifier. The name of the cluster. Structured like: projects/{project_number}/locations/{location}/clusters/{cluster_id}", + "type": "string" + }, + "rebalanceConfig": { + "$ref": "RebalanceConfig", + "description": "Optional. Rebalance configuration for the Kafka cluster." + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "state": { + "description": "Output only. The current state of the cluster.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "DELETING" + ], + "enumDescriptions": [ + "A state was not specified.", + "The cluster is being created.", + "The cluster is active.", + "The cluster is being deleted." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time when the cluster was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ConsumerGroup": { + "description": "A Kafka consumer group in a given cluster.", + "id": "ConsumerGroup", + "properties": { + "name": { + "description": "Identifier. The name of the consumer group. The `consumer_group` segment is used when connecting directly to the cluster. Structured like: projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/{consumer_group}", + "type": "string" + }, + "topics": { + "additionalProperties": { + "$ref": "ConsumerTopicMetadata" + }, + "description": "Optional. Metadata for this consumer group for all topics it has metadata for. The key of the map is a topic name, structured like: projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}", + "type": "object" + } + }, + "type": "object" + }, + "ConsumerPartitionMetadata": { + "description": "Metadata for a consumer group corresponding to a specific partition.", + "id": "ConsumerPartitionMetadata", + "properties": { + "metadata": { + "description": "Optional. The associated metadata for this partition, or empty if it does not exist.", + "type": "string" + }, + "offset": { + "description": "Required. The current offset for this partition, or 0 if no offset has been committed.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ConsumerTopicMetadata": { + "description": "Metadata for a consumer group corresponding to a specific topic.", + "id": "ConsumerTopicMetadata", + "properties": { + "partitions": { + "additionalProperties": { + "$ref": "ConsumerPartitionMetadata" + }, + "description": "Optional. Metadata for this consumer group and topic for all partition indexes it has metadata for.", + "type": "object" + } + }, + "type": "object" + }, + "Empty": { + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", + "id": "Empty", + "properties": {}, + "type": "object" + }, + "GcpConfig": { + "description": "Configuration properties for a Kafka cluster deployed to Google Cloud Platform.", + "id": "GcpConfig", + "properties": { + "accessConfig": { + "$ref": "AccessConfig", + "description": "Required. Access configuration for the Kafka cluster." + }, + "kmsKey": { + "description": "Optional. Immutable. The Cloud KMS Key name to use for encryption. The key must be located in the same region as the cluster and cannot be changed. Structured like: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.", + "type": "string" + } + }, + "type": "object" + }, + "ListClustersResponse": { + "description": "Response for ListClusters.", + "id": "ListClustersResponse", + "properties": { + "clusters": { + "description": "The list of Clusters in the requested parent.", + "items": { + "$ref": "Cluster" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token that can be sent as `page_token` to retrieve the next page of results. If this field is omitted, there are no more results.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListConsumerGroupsResponse": { + "description": "Response for ListConsumerGroups.", + "id": "ListConsumerGroupsResponse", + "properties": { + "consumerGroups": { + "description": "The list of consumer group in the requested parent. The order of the consumer groups is unspecified.", + "items": { + "$ref": "ConsumerGroup" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token that can be sent as `page_token` to retrieve the next page of results. If this field is omitted, there are no more results.", + "type": "string" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListTopicsResponse": { + "description": "Response for ListTopics.", + "id": "ListTopicsResponse", + "properties": { + "nextPageToken": { + "description": "A token that can be sent as `page_token` to retrieve the next page of results. If this field is omitted, there are no more results.", + "type": "string" + }, + "topics": { + "description": "The list of topics in the requested parent. The order of the topics is unspecified.", + "items": { + "$ref": "Topic" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "NetworkConfig": { + "description": "The configuration of a Virtual Private Cloud (VPC) network that can access the Kafka cluster.", + "id": "NetworkConfig", + "properties": { + "subnet": { + "description": "Required. Name of the VPC subnet in which to create Private Service Connect (PSC) endpoints for the Kafka brokers and bootstrap address. Structured like: projects/{project}/regions/{region}/subnetworks/{subnet_id} The subnet must be located in the same region as the Kafka cluster. The project may differ. Multiple subnets from the same parent network must not be specified.", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "Status", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RebalanceConfig": { + "description": "Defines rebalancing behavior of a Kafka cluster.", + "id": "RebalanceConfig", + "properties": { + "mode": { + "description": "Optional. The rebalance behavior for the cluster. When not specified, defaults to `NO_REBALANCE`.", + "enum": [ + "MODE_UNSPECIFIED", + "NO_REBALANCE", + "AUTO_REBALANCE_ON_SCALE_UP" + ], + "enumDescriptions": [ + "A mode was not specified. Do not use.", + "Do not rebalance automatically.", + "Automatically rebalance topic partitions among brokers when the cluster is scaled up." + ], + "type": "string" + } + }, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "Topic": { + "description": "A Kafka topic in a given cluster.", + "id": "Topic", + "properties": { + "configs": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Configurations for the topic that are overridden from the cluster defaults. The key of the map is a Kafka topic property name, for example: `cleanup.policy`, `compression.type`.", + "type": "object" + }, + "name": { + "description": "Identifier. The name of the topic. The `topic` segment is used when connecting directly to the cluster. Structured like: projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}", + "type": "string" + }, + "partitionCount": { + "description": "Required. The number of partitions this topic has. The partition count can only be increased, not decreased. Please note that if partitions are increased for a topic that has a key, the partitioning logic or the ordering of the messages will be affected.", + "format": "int32", + "type": "integer" + }, + "replicationFactor": { + "description": "Required. Immutable. The number of replicas of each partition. A replication factor of 3 is recommended for high availability.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Managed Service for Apache Kafka API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/managedkafka/v1/managedkafka-gen.go b/managedkafka/v1/managedkafka-gen.go new file mode 100644 index 0000000000..0309485c02 --- /dev/null +++ b/managedkafka/v1/managedkafka-gen.go @@ -0,0 +1,3296 @@ +// Copyright 2025 Google LLC. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package managedkafka provides access to the Managed Service for Apache Kafka API. +// +// For product documentation, see: https://cloud.google.com/managed-service-for-apache-kafka/docs +// +// # Library status +// +// These client libraries are officially supported by Google. However, this +// library is considered complete and is in maintenance mode. This means +// that we will address critical bugs and security issues but will not add +// any new features. +// +// When possible, we recommend using our newer +// [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) +// that are still actively being worked and iterated on. +// +// # Creating a client +// +// Usage example: +// +// import "google.golang.org/api/managedkafka/v1" +// ... +// ctx := context.Background() +// managedkafkaService, err := managedkafka.NewService(ctx) +// +// In this example, Google Application Default Credentials are used for +// authentication. For information on how to create and obtain Application +// Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. +// +// # Other authentication options +// +// To use an API key for authentication (note: some APIs do not support API +// keys), use [google.golang.org/api/option.WithAPIKey]: +// +// managedkafkaService, err := managedkafka.NewService(ctx, option.WithAPIKey("AIza...")) +// +// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth +// flow, use [google.golang.org/api/option.WithTokenSource]: +// +// config := &oauth2.Config{...} +// // ... +// token, err := config.Exchange(ctx, ...) +// managedkafkaService, err := managedkafka.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See [google.golang.org/api/option.ClientOption] for details on options. +package managedkafka // import "google.golang.org/api/managedkafka/v1" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "log/slog" + "net/http" + "net/url" + "strconv" + "strings" + + "github.com/googleapis/gax-go/v2/internallog" + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint +var _ = internal.Version +var _ = internallog.New + +const apiId = "managedkafka:v1" +const apiName = "managedkafka" +const apiVersion = "v1" +const basePath = "https://managedkafka.googleapis.com/" +const basePathTemplate = "https://managedkafka.UNIVERSE_DOMAIN/" +const mtlsBasePath = "https://managedkafka.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +const ( + // See, edit, configure, and delete your Google Cloud data and see the email + // address for your Google Account. + CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultEndpointTemplate(basePathTemplate)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + opts = append(opts, internaloption.EnableNewAuthLibrary()) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s := &Service{client: client, BasePath: basePath, logger: internaloption.GetLogger(opts)} + s.Projects = NewProjectsService(s) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + return NewService(context.TODO(), option.WithHTTPClient(client)) +} + +type Service struct { + client *http.Client + logger *slog.Logger + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewProjectsService(s *Service) *ProjectsService { + rs := &ProjectsService{s: s} + rs.Locations = NewProjectsLocationsService(s) + return rs +} + +type ProjectsService struct { + s *Service + + Locations *ProjectsLocationsService +} + +func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { + rs := &ProjectsLocationsService{s: s} + rs.Clusters = NewProjectsLocationsClustersService(s) + rs.Operations = NewProjectsLocationsOperationsService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + Clusters *ProjectsLocationsClustersService + + Operations *ProjectsLocationsOperationsService +} + +func NewProjectsLocationsClustersService(s *Service) *ProjectsLocationsClustersService { + rs := &ProjectsLocationsClustersService{s: s} + rs.ConsumerGroups = NewProjectsLocationsClustersConsumerGroupsService(s) + rs.Topics = NewProjectsLocationsClustersTopicsService(s) + return rs +} + +type ProjectsLocationsClustersService struct { + s *Service + + ConsumerGroups *ProjectsLocationsClustersConsumerGroupsService + + Topics *ProjectsLocationsClustersTopicsService +} + +func NewProjectsLocationsClustersConsumerGroupsService(s *Service) *ProjectsLocationsClustersConsumerGroupsService { + rs := &ProjectsLocationsClustersConsumerGroupsService{s: s} + return rs +} + +type ProjectsLocationsClustersConsumerGroupsService struct { + s *Service +} + +func NewProjectsLocationsClustersTopicsService(s *Service) *ProjectsLocationsClustersTopicsService { + rs := &ProjectsLocationsClustersTopicsService{s: s} + return rs +} + +type ProjectsLocationsClustersTopicsService struct { + s *Service +} + +func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { + rs := &ProjectsLocationsOperationsService{s: s} + return rs +} + +type ProjectsLocationsOperationsService struct { + s *Service +} + +// AccessConfig: The configuration of access to the Kafka cluster. +type AccessConfig struct { + // NetworkConfigs: Required. Virtual Private Cloud (VPC) networks that must be + // granted direct access to the Kafka cluster. Minimum of 1 network is + // required. Maximum 10 networks can be specified. + NetworkConfigs []*NetworkConfig `json:"networkConfigs,omitempty"` + // ForceSendFields is a list of field names (e.g. "NetworkConfigs") 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. "NetworkConfigs") 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 AccessConfig) MarshalJSON() ([]byte, error) { + type NoMethod AccessConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CancelOperationRequest: The request message for Operations.CancelOperation. +type CancelOperationRequest struct { +} + +// CapacityConfig: A capacity configuration of a Kafka cluster. +type CapacityConfig struct { + // MemoryBytes: Required. The memory to provision for the cluster in bytes. The + // CPU:memory ratio (vCPU:GiB) must be between 1:1 and 1:8. Minimum: 3221225472 + // (3 GiB). + MemoryBytes int64 `json:"memoryBytes,omitempty,string"` + // VcpuCount: Required. The number of vCPUs to provision for the cluster. + // Minimum: 3. + VcpuCount int64 `json:"vcpuCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MemoryBytes") 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. "MemoryBytes") 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 CapacityConfig) MarshalJSON() ([]byte, error) { + type NoMethod CapacityConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Cluster: An Apache Kafka cluster deployed in a location. +type Cluster struct { + // CapacityConfig: Required. Capacity configuration for the Kafka cluster. + CapacityConfig *CapacityConfig `json:"capacityConfig,omitempty"` + // CreateTime: Output only. The time when the cluster was created. + CreateTime string `json:"createTime,omitempty"` + // GcpConfig: Required. Configuration properties for a Kafka cluster deployed + // to Google Cloud Platform. + GcpConfig *GcpConfig `json:"gcpConfig,omitempty"` + // Labels: Optional. Labels as key value pairs. + Labels map[string]string `json:"labels,omitempty"` + // Name: Identifier. The name of the cluster. Structured like: + // projects/{project_number}/locations/{location}/clusters/{cluster_id} + Name string `json:"name,omitempty"` + // RebalanceConfig: Optional. Rebalance configuration for the Kafka cluster. + RebalanceConfig *RebalanceConfig `json:"rebalanceConfig,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` + // State: Output only. The current state of the cluster. + // + // Possible values: + // "STATE_UNSPECIFIED" - A state was not specified. + // "CREATING" - The cluster is being created. + // "ACTIVE" - The cluster is active. + // "DELETING" - The cluster is being deleted. + State string `json:"state,omitempty"` + // UpdateTime: Output only. The time when the cluster was last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CapacityConfig") 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. "CapacityConfig") 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 Cluster) MarshalJSON() ([]byte, error) { + type NoMethod Cluster + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ConsumerGroup: A Kafka consumer group in a given cluster. +type ConsumerGroup struct { + // Name: Identifier. The name of the consumer group. The `consumer_group` + // segment is used when connecting directly to the cluster. Structured like: + // projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/{co + // nsumer_group} + Name string `json:"name,omitempty"` + // Topics: Optional. Metadata for this consumer group for all topics it has + // metadata for. The key of the map is a topic name, structured like: + // projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic} + Topics map[string]ConsumerTopicMetadata `json:"topics,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // 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 ConsumerGroup) MarshalJSON() ([]byte, error) { + type NoMethod ConsumerGroup + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ConsumerPartitionMetadata: Metadata for a consumer group corresponding to a +// specific partition. +type ConsumerPartitionMetadata struct { + // Metadata: Optional. The associated metadata for this partition, or empty if + // it does not exist. + Metadata string `json:"metadata,omitempty"` + // Offset: Required. The current offset for this partition, or 0 if no offset + // has been committed. + Offset int64 `json:"offset,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "Metadata") 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. "Metadata") 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 ConsumerPartitionMetadata) MarshalJSON() ([]byte, error) { + type NoMethod ConsumerPartitionMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ConsumerTopicMetadata: Metadata for a consumer group corresponding to a +// specific topic. +type ConsumerTopicMetadata struct { + // Partitions: Optional. Metadata for this consumer group and topic for all + // partition indexes it has metadata for. + Partitions map[string]ConsumerPartitionMetadata `json:"partitions,omitempty"` + // ForceSendFields is a list of field names (e.g. "Partitions") 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. "Partitions") 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 ConsumerTopicMetadata) MarshalJSON() ([]byte, error) { + type NoMethod ConsumerTopicMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Empty: A generic empty message that you can re-use to avoid defining +// duplicated empty messages in your APIs. A typical example is to use it as +// the request or the response type of an API method. For instance: service Foo +// { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } +type Empty struct { + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` +} + +// GcpConfig: Configuration properties for a Kafka cluster deployed to Google +// Cloud Platform. +type GcpConfig struct { + // AccessConfig: Required. Access configuration for the Kafka cluster. + AccessConfig *AccessConfig `json:"accessConfig,omitempty"` + // KmsKey: Optional. Immutable. The Cloud KMS Key name to use for encryption. + // The key must be located in the same region as the cluster and cannot be + // changed. Structured like: + // projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypt + // o_key}. + KmsKey string `json:"kmsKey,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccessConfig") 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. "AccessConfig") 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 GcpConfig) MarshalJSON() ([]byte, error) { + type NoMethod GcpConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListClustersResponse: Response for ListClusters. +type ListClustersResponse struct { + // Clusters: The list of Clusters in the requested parent. + Clusters []*Cluster `json:"clusters,omitempty"` + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page of results. If this field is omitted, there are no more results. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Clusters") 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. "Clusters") 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 ListClustersResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListClustersResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListConsumerGroupsResponse: Response for ListConsumerGroups. +type ListConsumerGroupsResponse struct { + // ConsumerGroups: The list of consumer group in the requested parent. The + // order of the consumer groups is unspecified. + ConsumerGroups []*ConsumerGroup `json:"consumerGroups,omitempty"` + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page of results. If this field is omitted, there are no more results. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ConsumerGroups") 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. "ConsumerGroups") 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 ListConsumerGroupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListConsumerGroupsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListLocationsResponse: The response message for Locations.ListLocations. +type ListLocationsResponse struct { + // Locations: A list of locations that matches the specified filter in the + // request. + Locations []*Location `json:"locations,omitempty"` + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 ListLocationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListLocationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListOperationsResponse: The response message for Operations.ListOperations. +type ListOperationsResponse struct { + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + // Operations: A list of operations that matches the specified filter in the + // request. + Operations []*Operation `json:"operations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 ListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListOperationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListTopicsResponse: Response for ListTopics. +type ListTopicsResponse struct { + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page of results. If this field is omitted, there are no more results. + NextPageToken string `json:"nextPageToken,omitempty"` + // Topics: The list of topics in the requested parent. The order of the topics + // is unspecified. + Topics []*Topic `json:"topics,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 ListTopicsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListTopicsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Location: A resource that represents a Google Cloud location. +type Location struct { + // DisplayName: The friendly name for this location, typically a nearby city + // name. For example, "Tokyo". + DisplayName string `json:"displayName,omitempty"` + // Labels: Cross-service attributes for the location. For example + // {"cloud.googleapis.com/region": "us-east1"} + Labels map[string]string `json:"labels,omitempty"` + // LocationId: The canonical id for this location. For example: "us-east1". + LocationId string `json:"locationId,omitempty"` + // Metadata: Service-specific metadata. For example the available capacity at + // the given location. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: Resource name for the location, which may vary between + // implementations. For example: + // "projects/example-project/locations/us-east1" + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 Location) MarshalJSON() ([]byte, error) { + type NoMethod Location + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// NetworkConfig: The configuration of a Virtual Private Cloud (VPC) network +// that can access the Kafka cluster. +type NetworkConfig struct { + // Subnet: Required. Name of the VPC subnet in which to create Private Service + // Connect (PSC) endpoints for the Kafka brokers and bootstrap address. + // Structured like: projects/{project}/regions/{region}/subnetworks/{subnet_id} + // The subnet must be located in the same region as the Kafka cluster. The + // project may differ. Multiple subnets from the same parent network must not + // be specified. + Subnet string `json:"subnet,omitempty"` + // ForceSendFields is a list of field names (e.g. "Subnet") 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. "Subnet") 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 NetworkConfig) MarshalJSON() ([]byte, error) { + type NoMethod NetworkConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Operation: This resource represents a long-running operation that is the +// result of a network API call. +type Operation struct { + // Done: If the value is `false`, it means the operation is still in progress. + // If `true`, the operation is completed, and either `error` or `response` is + // available. + Done bool `json:"done,omitempty"` + // Error: The error result of the operation in case of failure or cancellation. + Error *Status `json:"error,omitempty"` + // Metadata: Service-specific metadata associated with the operation. It + // typically contains progress information and common metadata such as create + // time. Some services might not provide such metadata. Any method that returns + // a long-running operation should document the metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: The server-assigned name, which is only unique within the same service + // that originally returns it. If you use the default HTTP mapping, the `name` + // should be a resource name ending with `operations/{unique_id}`. + Name string `json:"name,omitempty"` + // Response: The normal, successful response of the operation. If the original + // method returns no data on success, such as `Delete`, the response is + // `google.protobuf.Empty`. If the original method is standard + // `Get`/`Create`/`Update`, the response should be the resource. For other + // methods, the response should have the type `XxxResponse`, where `Xxx` is the + // original method name. For example, if the original method name is + // `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. + Response googleapi.RawMessage `json:"response,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Done") 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. "Done") 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 Operation) MarshalJSON() ([]byte, error) { + type NoMethod Operation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OperationMetadata: Represents the metadata of the long-running operation. +type OperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + // RequestedCancellation: Output only. Identifies whether the user has + // requested cancellation of the operation. Operations that have been cancelled + // successfully have Operation.error value with a google.rpc.Status.code of 1, + // corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + // StatusMessage: Output only. Human-readable status of the operation, if any. + StatusMessage string `json:"statusMessage,omitempty"` + // Target: Output only. Server-defined resource path for the target of the + // operation. + Target string `json:"target,omitempty"` + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApiVersion") 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. "ApiVersion") 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 OperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod OperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RebalanceConfig: Defines rebalancing behavior of a Kafka cluster. +type RebalanceConfig struct { + // Mode: Optional. The rebalance behavior for the cluster. When not specified, + // defaults to `NO_REBALANCE`. + // + // Possible values: + // "MODE_UNSPECIFIED" - A mode was not specified. Do not use. + // "NO_REBALANCE" - Do not rebalance automatically. + // "AUTO_REBALANCE_ON_SCALE_UP" - Automatically rebalance topic partitions + // among brokers when the cluster is scaled up. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") 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. "Mode") 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 RebalanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod RebalanceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Status: The `Status` type defines a logical error model that is suitable for +// different programming environments, including REST APIs and RPC APIs. It is +// used by gRPC (https://github.com/grpc). Each `Status` message contains three +// pieces of data: error code, error message, and error details. You can find +// out more about this error model and how to work with it in the API Design +// Guide (https://cloud.google.com/apis/design/errors). +type Status struct { + // Code: The status code, which should be an enum value of google.rpc.Code. + Code int64 `json:"code,omitempty"` + // Details: A list of messages that carry the error details. There is a common + // set of message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + // Message: A developer-facing error message, which should be in English. Any + // user-facing error message should be localized and sent in the + // google.rpc.Status.details field, or localized by the client. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") 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. "Code") 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 Status) MarshalJSON() ([]byte, error) { + type NoMethod Status + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Topic: A Kafka topic in a given cluster. +type Topic struct { + // Configs: Optional. Configurations for the topic that are overridden from the + // cluster defaults. The key of the map is a Kafka topic property name, for + // example: `cleanup.policy`, `compression.type`. + Configs map[string]string `json:"configs,omitempty"` + // Name: Identifier. The name of the topic. The `topic` segment is used when + // connecting directly to the cluster. Structured like: + // projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic} + Name string `json:"name,omitempty"` + // PartitionCount: Required. The number of partitions this topic has. The + // partition count can only be increased, not decreased. Please note that if + // partitions are increased for a topic that has a key, the partitioning logic + // or the ordering of the messages will be affected. + PartitionCount int64 `json:"partitionCount,omitempty"` + // ReplicationFactor: Required. Immutable. The number of replicas of each + // partition. A replication factor of 3 is recommended for high availability. + ReplicationFactor int64 `json:"replicationFactor,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Configs") 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. "Configs") 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 Topic) MarshalJSON() ([]byte, error) { + type NoMethod Topic + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about a location. +// +// - name: Resource name for the location. +func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { + c := &ProjectsLocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Location.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Location{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists information about the supported locations for this service. +// +// - name: The resource that owns the locations collection, if applicable. +func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { + c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": A filter to narrow down results +// to a preferred subset. The filtering language accepts strings like +// "displayName=tokyo", and is documented in more detail in AIP-160 +// (https://google.aip.dev/160). +func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return. If not set, the service selects a default. +func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from the `next_page_token` field in the response. Send that page token to +// receive the subsequent page. +func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListLocationsResponse.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListLocationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsClustersCreateCall struct { + s *Service + parent string + cluster *Cluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new cluster in a given project and location. +// +// - parent: The parent region in which to create the cluster. Structured like +// `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsClustersService) Create(parent string, cluster *Cluster) *ProjectsLocationsClustersCreateCall { + c := &ProjectsLocationsClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.cluster = cluster + return c +} + +// ClusterId sets the optional parameter "clusterId": Required. The ID to use +// for the cluster, which will become the final component of the cluster's +// name. The ID must be 1-63 characters long, and match the regular expression +// `[a-z]([-a-z0-9]*[a-z0-9])?` to comply with RFC 1035. This value is +// structured like: `my-cluster-id`. +func (c *ProjectsLocationsClustersCreateCall) ClusterId(clusterId string) *ProjectsLocationsClustersCreateCall { + c.urlParams_.Set("clusterId", clusterId) + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID to avoid duplication of +// requests. If a request times out or fails, retrying with the same ID allows +// the server to recognize the previous attempt. For at least 60 minutes, the +// server ignores duplicate requests bearing the same ID. For example, consider +// a situation where you make an initial request and the request times out. If +// you make the request again with the same request ID within 60 minutes of the +// last request, the server checks if an original operation with the same +// request ID was received. If so, the server ignores the second request. The +// request ID must be a valid UUID. A zero UUID is not supported +// (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsClustersCreateCall) RequestId(requestId string) *ProjectsLocationsClustersCreateCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersCreateCall) Context(ctx context.Context) *ProjectsLocationsClustersCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.cluster) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/clusters") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single cluster. +// +// - name: The name of the cluster to delete. +func (r *ProjectsLocationsClustersService) Delete(name string) *ProjectsLocationsClustersDeleteCall { + c := &ProjectsLocationsClustersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID to avoid duplication of +// requests. If a request times out or fails, retrying with the same ID allows +// the server to recognize the previous attempt. For at least 60 minutes, the +// server ignores duplicate requests bearing the same ID. For example, consider +// a situation where you make an initial request and the request times out. If +// you make the request again with the same request ID within 60 minutes of the +// last request, the server checks if an original operation with the same +// request ID was received. If so, the server ignores the second request. The +// request ID must be a valid UUID. A zero UUID is not supported +// (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsClustersDeleteCall) RequestId(requestId string) *ProjectsLocationsClustersDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersDeleteCall) Context(ctx context.Context) *ProjectsLocationsClustersDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the properties of a single cluster. +// +// - name: The name of the cluster whose configuration to return. +func (r *ProjectsLocationsClustersService) Get(name string) *ProjectsLocationsClustersGetCall { + c := &ProjectsLocationsClustersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClustersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsClustersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersGetCall) Context(ctx context.Context) *ProjectsLocationsClustersGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Cluster.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersGetCall) Do(opts ...googleapi.CallOption) (*Cluster, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Cluster{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the clusters in a given project and location. +// +// - parent: The parent location whose clusters are to be listed. Structured +// like `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsClustersService) List(parent string) *ProjectsLocationsClustersListCall { + c := &ProjectsLocationsClustersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter expression for the +// result. +func (c *ProjectsLocationsClustersListCall) Filter(filter string) *ProjectsLocationsClustersListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Order by fields for the +// result. +func (c *ProjectsLocationsClustersListCall) OrderBy(orderBy string) *ProjectsLocationsClustersListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// clusters to return. The service may return fewer than this value. If +// unspecified, server will pick an appropriate default. +func (c *ProjectsLocationsClustersListCall) PageSize(pageSize int64) *ProjectsLocationsClustersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListClusters` call. Provide this to retrieve the subsequent +// page. When paginating, all other parameters provided to `ListClusters` must +// match the call that provided the page token. +func (c *ProjectsLocationsClustersListCall) PageToken(pageToken string) *ProjectsLocationsClustersListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersListCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClustersListCall) IfNoneMatch(entityTag string) *ProjectsLocationsClustersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersListCall) Context(ctx context.Context) *ProjectsLocationsClustersListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/clusters") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListClustersResponse.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsClustersListCall) Do(opts ...googleapi.CallOption) (*ListClustersResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListClustersResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsClustersListCall) Pages(ctx context.Context, f func(*ListClustersResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsClustersPatchCall struct { + s *Service + name string + cluster *Cluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the properties of a single cluster. +// +// - name: Identifier. The name of the cluster. Structured like: +// projects/{project_number}/locations/{location}/clusters/{cluster_id}. +func (r *ProjectsLocationsClustersService) Patch(name string, cluster *Cluster) *ProjectsLocationsClustersPatchCall { + c := &ProjectsLocationsClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.cluster = cluster + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID to avoid duplication of +// requests. If a request times out or fails, retrying with the same ID allows +// the server to recognize the previous attempt. For at least 60 minutes, the +// server ignores duplicate requests bearing the same ID. For example, consider +// a situation where you make an initial request and the request times out. If +// you make the request again with the same request ID within 60 minutes of the +// last request, the server checks if an original operation with the same +// request ID was received. If so, the server ignores the second request. The +// request ID must be a valid UUID. A zero UUID is not supported +// (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsClustersPatchCall) RequestId(requestId string) *ProjectsLocationsClustersPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field mask is +// used to specify the fields to be overwritten in the cluster resource by the +// update. The fields specified in the update_mask are relative to the +// resource, not the full request. A field will be overwritten if it is in the +// mask. The mask is required and a value of * will update all fields. +func (c *ProjectsLocationsClustersPatchCall) UpdateMask(updateMask string) *ProjectsLocationsClustersPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersPatchCall) Context(ctx context.Context) *ProjectsLocationsClustersPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.cluster) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersConsumerGroupsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single consumer group. +// +// - name: The name of the consumer group to delete. +// `projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/ +// {consumerGroup}`. +func (r *ProjectsLocationsClustersConsumerGroupsService) Delete(name string) *ProjectsLocationsClustersConsumerGroupsDeleteCall { + c := &ProjectsLocationsClustersConsumerGroupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersConsumerGroupsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersConsumerGroupsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersConsumerGroupsDeleteCall) Context(ctx context.Context) *ProjectsLocationsClustersConsumerGroupsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersConsumerGroupsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersConsumerGroupsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.consumerGroups.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersConsumerGroupsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersConsumerGroupsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the properties of a single consumer group. +// +// - name: The name of the consumer group whose configuration to return. +// `projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/ +// {consumerGroup}`. +func (r *ProjectsLocationsClustersConsumerGroupsService) Get(name string) *ProjectsLocationsClustersConsumerGroupsGetCall { + c := &ProjectsLocationsClustersConsumerGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersConsumerGroupsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersConsumerGroupsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClustersConsumerGroupsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsClustersConsumerGroupsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersConsumerGroupsGetCall) Context(ctx context.Context) *ProjectsLocationsClustersConsumerGroupsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersConsumerGroupsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersConsumerGroupsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.consumerGroups.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *ConsumerGroup.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersConsumerGroupsGetCall) Do(opts ...googleapi.CallOption) (*ConsumerGroup, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ConsumerGroup{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersConsumerGroupsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the consumer groups in a given cluster. +// +// - parent: The parent cluster whose consumer groups are to be listed. +// Structured like +// `projects/{project}/locations/{location}/clusters/{cluster}`. +func (r *ProjectsLocationsClustersConsumerGroupsService) List(parent string) *ProjectsLocationsClustersConsumerGroupsListCall { + c := &ProjectsLocationsClustersConsumerGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// consumer groups to return. The service may return fewer than this value. If +// unset or zero, all consumer groups for the parent is returned. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) PageSize(pageSize int64) *ProjectsLocationsClustersConsumerGroupsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListConsumerGroups` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListConsumerGroups` must match the call that provided the page token. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) PageToken(pageToken string) *ProjectsLocationsClustersConsumerGroupsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersConsumerGroupsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsClustersConsumerGroupsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) Context(ctx context.Context) *ProjectsLocationsClustersConsumerGroupsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersConsumerGroupsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/consumerGroups") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.consumerGroups.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListConsumerGroupsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) Do(opts ...googleapi.CallOption) (*ListConsumerGroupsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListConsumerGroupsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsClustersConsumerGroupsListCall) Pages(ctx context.Context, f func(*ListConsumerGroupsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsClustersConsumerGroupsPatchCall struct { + s *Service + name string + consumergroup *ConsumerGroup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the properties of a single consumer group. +// +// - name: Identifier. The name of the consumer group. The `consumer_group` +// segment is used when connecting directly to the cluster. Structured like: +// projects/{project}/locations/{location}/clusters/{cluster}/consumerGroups/{ +// consumer_group}. +func (r *ProjectsLocationsClustersConsumerGroupsService) Patch(name string, consumergroup *ConsumerGroup) *ProjectsLocationsClustersConsumerGroupsPatchCall { + c := &ProjectsLocationsClustersConsumerGroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.consumergroup = consumergroup + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field mask is +// used to specify the fields to be overwritten in the ConsumerGroup resource +// by the update. The fields specified in the update_mask are relative to the +// resource, not the full request. A field will be overwritten if it is in the +// mask. The mask is required and a value of * will update all fields. +func (c *ProjectsLocationsClustersConsumerGroupsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsClustersConsumerGroupsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersConsumerGroupsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersConsumerGroupsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersConsumerGroupsPatchCall) Context(ctx context.Context) *ProjectsLocationsClustersConsumerGroupsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersConsumerGroupsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersConsumerGroupsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.consumergroup) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.consumerGroups.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *ConsumerGroup.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersConsumerGroupsPatchCall) Do(opts ...googleapi.CallOption) (*ConsumerGroup, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ConsumerGroup{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.consumerGroups.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersTopicsCreateCall struct { + s *Service + parent string + topic *Topic + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new topic in a given project and location. +// +// - parent: The parent cluster in which to create the topic. Structured like +// `projects/{project}/locations/{location}/clusters/{cluster}`. +func (r *ProjectsLocationsClustersTopicsService) Create(parent string, topic *Topic) *ProjectsLocationsClustersTopicsCreateCall { + c := &ProjectsLocationsClustersTopicsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.topic = topic + return c +} + +// TopicId sets the optional parameter "topicId": Required. The ID to use for +// the topic, which will become the final component of the topic's name. This +// value is structured like: `my-topic-name`. +func (c *ProjectsLocationsClustersTopicsCreateCall) TopicId(topicId string) *ProjectsLocationsClustersTopicsCreateCall { + c.urlParams_.Set("topicId", topicId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersTopicsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersTopicsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersTopicsCreateCall) Context(ctx context.Context) *ProjectsLocationsClustersTopicsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersTopicsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersTopicsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.topic) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/topics") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.topics.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *Topic.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersTopicsCreateCall) Do(opts ...googleapi.CallOption) (*Topic, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Topic{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersTopicsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single topic. +// +// - name: The name of the topic to delete. +// `projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}` +// . +func (r *ProjectsLocationsClustersTopicsService) Delete(name string) *ProjectsLocationsClustersTopicsDeleteCall { + c := &ProjectsLocationsClustersTopicsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersTopicsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersTopicsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersTopicsDeleteCall) Context(ctx context.Context) *ProjectsLocationsClustersTopicsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersTopicsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersTopicsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.topics.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersTopicsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersTopicsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the properties of a single topic. +// +// - name: The name of the topic whose configuration to return. Structured +// like: +// projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}. +func (r *ProjectsLocationsClustersTopicsService) Get(name string) *ProjectsLocationsClustersTopicsGetCall { + c := &ProjectsLocationsClustersTopicsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersTopicsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersTopicsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClustersTopicsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsClustersTopicsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersTopicsGetCall) Context(ctx context.Context) *ProjectsLocationsClustersTopicsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersTopicsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersTopicsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.topics.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Topic.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersTopicsGetCall) Do(opts ...googleapi.CallOption) (*Topic, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Topic{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsClustersTopicsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the topics in a given cluster. +// +// - parent: The parent cluster whose topics are to be listed. Structured like +// `projects/{project}/locations/{location}/clusters/{cluster}`. +func (r *ProjectsLocationsClustersTopicsService) List(parent string) *ProjectsLocationsClustersTopicsListCall { + c := &ProjectsLocationsClustersTopicsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// topics to return. The service may return fewer than this value. If unset or +// zero, all topics for the parent is returned. +func (c *ProjectsLocationsClustersTopicsListCall) PageSize(pageSize int64) *ProjectsLocationsClustersTopicsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListTopics` call. Provide this to retrieve the subsequent +// page. When paginating, all other parameters provided to `ListTopics` must +// match the call that provided the page token. +func (c *ProjectsLocationsClustersTopicsListCall) PageToken(pageToken string) *ProjectsLocationsClustersTopicsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersTopicsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersTopicsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsClustersTopicsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsClustersTopicsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersTopicsListCall) Context(ctx context.Context) *ProjectsLocationsClustersTopicsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersTopicsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersTopicsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/topics") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.topics.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListTopicsResponse.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsClustersTopicsListCall) Do(opts ...googleapi.CallOption) (*ListTopicsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListTopicsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsClustersTopicsListCall) Pages(ctx context.Context, f func(*ListTopicsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsClustersTopicsPatchCall struct { + s *Service + name string + topic *Topic + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the properties of a single topic. +// +// - name: Identifier. The name of the topic. The `topic` segment is used when +// connecting directly to the cluster. Structured like: +// projects/{project}/locations/{location}/clusters/{cluster}/topics/{topic}. +func (r *ProjectsLocationsClustersTopicsService) Patch(name string, topic *Topic) *ProjectsLocationsClustersTopicsPatchCall { + c := &ProjectsLocationsClustersTopicsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.topic = topic + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field mask is +// used to specify the fields to be overwritten in the Topic resource by the +// update. The fields specified in the update_mask are relative to the +// resource, not the full request. A field will be overwritten if it is in the +// mask. The mask is required and a value of * will update all fields. +func (c *ProjectsLocationsClustersTopicsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsClustersTopicsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsClustersTopicsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersTopicsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersTopicsPatchCall) Context(ctx context.Context) *ProjectsLocationsClustersTopicsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsClustersTopicsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersTopicsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.topic) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.clusters.topics.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Topic.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsClustersTopicsPatchCall) Do(opts ...googleapi.CallOption) (*Topic, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Topic{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.clusters.topics.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. The +// server makes a best effort to cancel the operation, but success is not +// guaranteed. If the server doesn't support this method, it returns +// `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or +// other methods to check whether the cancellation succeeded or whether the +// operation completed despite cancellation. On successful cancellation, the +// operation is not deleted; instead, it becomes an operation with an +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { + c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.canceloperationrequest = canceloperationrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.canceloperationrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.operations.cancel" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.cancel", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a long-running operation. This method indicates that the +// client is no longer interested in the operation result. It does not cancel +// the operation. If the server doesn't support this method, it returns +// `google.rpc.Code.UNIMPLEMENTED`. +// +// - name: The name of the operation resource to be deleted. +func (r *ProjectsLocationsOperationsService) Delete(name string) *ProjectsLocationsOperationsDeleteCall { + c := &ProjectsLocationsOperationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsOperationsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.operations.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { + c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.operations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { + c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "managedkafka.projects.locations.operations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListOperationsResponse.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListOperationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "managedkafka.projects.locations.operations.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} diff --git a/merchantapi/accounts_v1beta/merchantapi-api.json b/merchantapi/accounts_v1beta/merchantapi-api.json index 14b556b798..68109fdd3a 100644 --- a/merchantapi/accounts_v1beta/merchantapi-api.json +++ b/merchantapi/accounts_v1beta/merchantapi-api.json @@ -180,6 +180,31 @@ "https://www.googleapis.com/auth/content" ] }, + "getAutomaticImprovements": { + "description": "Retrieves the automatic improvements of an account.", + "flatPath": "accounts/v1beta/accounts/{accountsId}/automaticImprovements", + "httpMethod": "GET", + "id": "merchantapi.accounts.getAutomaticImprovements", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`", + "location": "path", + "pattern": "^accounts/[^/]+/automaticImprovements$", + "required": true, + "type": "string" + } + }, + "path": "accounts/v1beta/{+name}", + "response": { + "$ref": "AutomaticImprovements" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] + }, "list": { "description": "Lists accounts accessible to the calling user and matching the constraints of the request such as page size or filters. This is not just listing the sub-accounts of an MCA, but all accounts the calling user has access to including other MCAs, linked accounts, standalone accounts and so on. If no filter is provided, then it returns all the accounts the user has access to. This method is eventually consistent, meaning changes such as creating, updating an account or a change of relationships between accounts may not show up in the results immediately. Instead, these changes propagate over a short period, after which the updated information can match the associated predicates. That means, that searching by account name might not return a recently changed account even though it satisfies the predicate.", "flatPath": "accounts/v1beta/accounts", @@ -281,6 +306,40 @@ "scopes": [ "https://www.googleapis.com/auth/content" ] + }, + "updateAutomaticImprovements": { + "description": "Updates the automatic improvements of an account.", + "flatPath": "accounts/v1beta/accounts/{accountsId}/automaticImprovements", + "httpMethod": "PATCH", + "id": "merchantapi.accounts.updateAutomaticImprovements", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.", + "location": "path", + "pattern": "^accounts/[^/]+/automaticImprovements$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `item_updates` - `item_updates.account_level_settings` - `image_improvements` - `image_improvements.account_level_settings` - `shipping_improvements` - `shipping_improvements.allow_shipping_improvements`", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "accounts/v1beta/{+name}", + "request": { + "$ref": "AutomaticImprovements" + }, + "response": { + "$ref": "AutomaticImprovements" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] } }, "resources": { @@ -1417,7 +1476,7 @@ } } }, - "revision": "20250301", + "revision": "20250317", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Accepted": { @@ -1606,6 +1665,87 @@ }, "type": "object" }, + "AutomaticImageImprovements": { + "description": "This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973)", + "id": "AutomaticImageImprovements", + "properties": { + "accountImageImprovementsSettings": { + "$ref": "ImageImprovementsAccountLevelSettings", + "description": "Optional. Determines how the images should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator." + }, + "effectiveAllowAutomaticImageImprovements": { + "description": "Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "AutomaticImprovements": { + "description": "Collection of information related to the [automatic improvements](https://developers.google.com/shopping-content/guides/automatic-improvements) of an account.", + "id": "AutomaticImprovements", + "properties": { + "imageImprovements": { + "$ref": "AutomaticImageImprovements", + "description": "This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided in the update mask." + }, + "itemUpdates": { + "$ref": "AutomaticItemUpdates", + "description": "Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided in the update mask." + }, + "name": { + "description": "Identifier. The resource name of the automatic improvements. Format: `accounts/{account}/automaticImprovements`.", + "type": "string" + }, + "shippingImprovements": { + "$ref": "AutomaticShippingImprovements", + "description": "Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data This field is only updated (cleared) if provided in the update mask." + } + }, + "type": "object" + }, + "AutomaticItemUpdates": { + "description": "Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown.", + "id": "AutomaticItemUpdates", + "properties": { + "accountItemUpdatesSettings": { + "$ref": "ItemUpdatesAccountLevelSettings", + "description": "Optional. Determines which attributes of the items should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator." + }, + "effectiveAllowAvailabilityUpdates": { + "description": "Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.", + "readOnly": true, + "type": "boolean" + }, + "effectiveAllowConditionUpdates": { + "description": "Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.", + "readOnly": true, + "type": "boolean" + }, + "effectiveAllowPriceUpdates": { + "description": "Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.", + "readOnly": true, + "type": "boolean" + }, + "effectiveAllowStrictAvailabilityUpdates": { + "description": "Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "AutomaticShippingImprovements": { + "description": "Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data", + "id": "AutomaticShippingImprovements", + "properties": { + "allowShippingImprovements": { + "description": "Enables automatic shipping improvements.", + "type": "boolean" + } + }, + "type": "object" + }, "BusinessDayConfig": { "description": "Business days of the warehouse.", "id": "BusinessDayConfig", @@ -2123,6 +2263,17 @@ }, "type": "object" }, + "ImageImprovementsAccountLevelSettings": { + "description": "Settings for the Automatic Image Improvements.", + "id": "ImageImprovementsAccountLevelSettings", + "properties": { + "allowAutomaticImageImprovements": { + "description": "Enables automatic image improvements.", + "type": "boolean" + } + }, + "type": "object" + }, "Impact": { "description": "The impact of the issue on a region.", "id": "Impact", @@ -2231,6 +2382,29 @@ }, "type": "object" }, + "ItemUpdatesAccountLevelSettings": { + "description": "Settings for the Automatic Item Updates.", + "id": "ItemUpdatesAccountLevelSettings", + "properties": { + "allowAvailabilityUpdates": { + "description": "If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_strict_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.", + "type": "boolean" + }, + "allowConditionUpdates": { + "description": "If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.", + "type": "boolean" + }, + "allowPriceUpdates": { + "description": "If price updates are enabled, Google always updates the active price with the crawled information.", + "type": "boolean" + }, + "allowStrictAvailabilityUpdates": { + "description": "If `allow_availability_updates` is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also set `allow_availability_updates`.", + "type": "boolean" + } + }, + "type": "object" + }, "ListAccountIssuesResponse": { "description": "Response message for the `ListAccountIssues` method.", "id": "ListAccountIssuesResponse", @@ -2451,7 +2625,7 @@ "type": "array" }, "itemConditions": { - "description": "The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.", + "description": "Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.", "items": { "enum": [ "ITEM_CONDITION_UNSPECIFIED", @@ -2477,7 +2651,7 @@ }, "policy": { "$ref": "Policy", - "description": "The return policy." + "description": "Optional. The return policy." }, "processRefundDays": { "description": "The field specifies the number of days it takes for merchants to process refunds, field is optional.", @@ -2486,10 +2660,10 @@ }, "restockingFee": { "$ref": "RestockingFee", - "description": "The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set." + "description": "Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set." }, "returnMethods": { - "description": "The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.", + "description": "Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.", "items": { "enum": [ "RETURN_METHOD_UNSPECIFIED", @@ -2518,7 +2692,7 @@ }, "returnShippingFee": { "$ref": "ReturnShippingFee", - "description": "The return shipping fee. Should be set only when customer need to download and print the return label." + "description": "Optional. The return shipping fee. Should be set only when customer need to download and print the return label." }, "seasonalOverrides": { "description": "Optional. Overrides to the general policy for orders placed during a specific set of time intervals.", @@ -2798,7 +2972,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, @@ -3054,11 +3228,7 @@ "SeasonalOverride": { "id": "SeasonalOverride", "properties": { - "begin": { - "$ref": "Date", - "description": "Required. Defines the date range when this seasonal override applies. Both begin and end are inclusive and should be in date decimal format, example 20250115. The dates of the seasonal overrides should not overlap." - }, - "end": { + "endDate": { "$ref": "Date", "description": "Required. seasonal override end date (inclusive)." }, @@ -3066,11 +3236,6 @@ "description": "Required. Display name of this seasonal override in Merchant Center.", "type": "string" }, - "policy": { - "$ref": "Policy", - "deprecated": true, - "description": "The return policy for the given date range." - }, "returnDays": { "description": "Number of days (from the delivery date) that the product can be returned.", "format": "int32", @@ -3079,6 +3244,10 @@ "returnUntilDate": { "$ref": "Date", "description": "Fixed end date until which the product can be returned." + }, + "startDate": { + "$ref": "Date", + "description": "Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap." } }, "type": "object" diff --git a/merchantapi/accounts_v1beta/merchantapi-gen.go b/merchantapi/accounts_v1beta/merchantapi-gen.go index 33b991c09d..a667090534 100644 --- a/merchantapi/accounts_v1beta/merchantapi-gen.go +++ b/merchantapi/accounts_v1beta/merchantapi-gen.go @@ -582,6 +582,188 @@ func (s AutofeedSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AutomaticImageImprovements: This improvement will attempt to automatically +// correct submitted images if they don't meet the image requirements +// (https://support.google.com/merchants/answer/6324350), for example, removing +// overlays. If successful, the image will be replaced and approved. This +// improvement is only applied to images of disapproved offers. For more +// information see: Automatic image improvements +// (https://support.google.com/merchants/answer/9242973) +type AutomaticImageImprovements struct { + // AccountImageImprovementsSettings: Optional. Determines how the images should + // be automatically updated. If this field is not present and provided in the + // update mask, then the settings will be deleted. If there are no settings for + // subaccount, they are inherited from aggregator. + AccountImageImprovementsSettings *ImageImprovementsAccountLevelSettings `json:"accountImageImprovementsSettings,omitempty"` + // EffectiveAllowAutomaticImageImprovements: Output only. The effective value + // of allow_automatic_image_improvements. If + // account_image_improvements_settings is present, then this value is the same. + // Otherwise, it represents the inherited value of the parent account. + // Read-only. + EffectiveAllowAutomaticImageImprovements bool `json:"effectiveAllowAutomaticImageImprovements,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "AccountImageImprovementsSettings") 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. + // "AccountImageImprovementsSettings") 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 AutomaticImageImprovements) MarshalJSON() ([]byte, error) { + type NoMethod AutomaticImageImprovements + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AutomaticImprovements: Collection of information related to the automatic +// improvements +// (https://developers.google.com/shopping-content/guides/automatic-improvements) +// of an account. +type AutomaticImprovements struct { + // ImageImprovements: This improvement will attempt to automatically correct + // submitted images if they don't meet the image requirements + // (https://support.google.com/merchants/answer/6324350), for example, removing + // overlays. If successful, the image will be replaced and approved. This + // improvement is only applied to images of disapproved offers. For more + // information see: Automatic image improvements + // (https://support.google.com/merchants/answer/9242973) This field is only + // updated (cleared) if provided in the update mask. + ImageImprovements *AutomaticImageImprovements `json:"imageImprovements,omitempty"` + // ItemUpdates: Turning on item updates + // (https://support.google.com/merchants/answer/3246284) allows Google to + // automatically update items for you. When item updates are on, Google uses + // the structured data markup on the website and advanced data extractors to + // update the price and availability of the items. When the item updates are + // off, items with mismatched data aren't shown. This field is only updated + // (cleared) if provided in the update mask. + ItemUpdates *AutomaticItemUpdates `json:"itemUpdates,omitempty"` + // Name: Identifier. The resource name of the automatic improvements. Format: + // `accounts/{account}/automaticImprovements`. + Name string `json:"name,omitempty"` + // ShippingImprovements: Not available for MCAs accounts + // (https://support.google.com/merchants/answer/188487). By turning on + // automatic shipping improvements + // (https://support.google.com/merchants/answer/10027038), you are allowing + // Google to improve the accuracy of your delivery times shown to shoppers + // using Google. More accurate delivery times, especially when faster, + // typically lead to better conversion rates. Google will improve your + // estimated delivery times based on various factors: * Delivery address of an + // order * Current handling time and shipping time settings * Estimated + // weekdays or business days * Parcel tracking data This field is only updated + // (cleared) if provided in the update mask. + ShippingImprovements *AutomaticShippingImprovements `json:"shippingImprovements,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ImageImprovements") 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. "ImageImprovements") 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 AutomaticImprovements) MarshalJSON() ([]byte, error) { + type NoMethod AutomaticImprovements + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AutomaticItemUpdates: Turning on item updates +// (https://support.google.com/merchants/answer/3246284) allows Google to +// automatically update items for you. When item updates are on, Google uses +// the structured data markup on the website and advanced data extractors to +// update the price and availability of the items. When the item updates are +// off, items with mismatched data aren't shown. +type AutomaticItemUpdates struct { + // AccountItemUpdatesSettings: Optional. Determines which attributes of the + // items should be automatically updated. If this field is not present and + // provided in the update mask, then the settings will be deleted. If there are + // no settings for subaccount, they are inherited from aggregator. + AccountItemUpdatesSettings *ItemUpdatesAccountLevelSettings `json:"accountItemUpdatesSettings,omitempty"` + // EffectiveAllowAvailabilityUpdates: Output only. The effective value of + // allow_availability_updates. If account_item_updates_settings is present, + // then this value is the same. Otherwise, it represents the inherited value of + // the parent account. The default value is true if no settings are present. + // Read-only. + EffectiveAllowAvailabilityUpdates bool `json:"effectiveAllowAvailabilityUpdates,omitempty"` + // EffectiveAllowConditionUpdates: Output only. The effective value of + // allow_condition_updates. If account_item_updates_settings is present, then + // this value is the same. Otherwise, it represents the inherited value of the + // parent account. The default value is true if no settings are present. + // Read-only. + EffectiveAllowConditionUpdates bool `json:"effectiveAllowConditionUpdates,omitempty"` + // EffectiveAllowPriceUpdates: Output only. The effective value of + // allow_price_updates. If account_item_updates_settings is present, then this + // value is the same. Otherwise, it represents the inherited value of the + // parent account. The default value is true if no settings are present. + // Read-only. + EffectiveAllowPriceUpdates bool `json:"effectiveAllowPriceUpdates,omitempty"` + // EffectiveAllowStrictAvailabilityUpdates: Output only. The effective value of + // allow_strict_availability_updates. If account_item_updates_settings is + // present, then this value is the same. Otherwise, it represents the inherited + // value of the parent account. The default value is true if no settings are + // present. Read-only. + EffectiveAllowStrictAvailabilityUpdates bool `json:"effectiveAllowStrictAvailabilityUpdates,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccountItemUpdatesSettings") + // 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. "AccountItemUpdatesSettings") 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 AutomaticItemUpdates) MarshalJSON() ([]byte, error) { + type NoMethod AutomaticItemUpdates + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AutomaticShippingImprovements: Not available for MCAs accounts +// (https://support.google.com/merchants/answer/188487). By turning on +// automatic shipping improvements +// (https://support.google.com/merchants/answer/10027038), you are allowing +// Google to improve the accuracy of your delivery times shown to shoppers +// using Google. More accurate delivery times, especially when faster, +// typically lead to better conversion rates. Google will improve your +// estimated delivery times based on various factors: * Delivery address of an +// order * Current handling time and shipping time settings * Estimated +// weekdays or business days * Parcel tracking data +type AutomaticShippingImprovements struct { + // AllowShippingImprovements: Enables automatic shipping improvements. + AllowShippingImprovements bool `json:"allowShippingImprovements,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowShippingImprovements") + // 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. "AllowShippingImprovements") 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 AutomaticShippingImprovements) MarshalJSON() ([]byte, error) { + type NoMethod AutomaticShippingImprovements + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BusinessDayConfig: Business days of the warehouse. type BusinessDayConfig struct { // BusinessDays: Required. Regular business days. May not be empty. @@ -1271,6 +1453,30 @@ func (s IdentityAttribute) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ImageImprovementsAccountLevelSettings: Settings for the Automatic Image +// Improvements. +type ImageImprovementsAccountLevelSettings struct { + // AllowAutomaticImageImprovements: Enables automatic image improvements. + AllowAutomaticImageImprovements bool `json:"allowAutomaticImageImprovements,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "AllowAutomaticImageImprovements") 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. "AllowAutomaticImageImprovements") + // 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 ImageImprovementsAccountLevelSettings) MarshalJSON() ([]byte, error) { + type NoMethod ImageImprovementsAccountLevelSettings + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Impact: The impact of the issue on a region. type Impact struct { // RegionCode: The CLDR region code (https://cldr.unicode.org/) where this @@ -1365,6 +1571,47 @@ func (s ImpactedDestination) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ItemUpdatesAccountLevelSettings: Settings for the Automatic Item Updates. +type ItemUpdatesAccountLevelSettings struct { + // AllowAvailabilityUpdates: If availability updates are enabled, any previous + // availability values get overwritten if Google finds an out-of-stock + // annotation on the offer's page. If additionally + // `allow_strict_availability_updates` field is set to true, values get + // overwritten if Google finds an in-stock annotation on the offer’s page. + AllowAvailabilityUpdates bool `json:"allowAvailabilityUpdates,omitempty"` + // AllowConditionUpdates: If condition updates are enabled, Google always + // updates item condition with the condition detected from the details of your + // product. + AllowConditionUpdates bool `json:"allowConditionUpdates,omitempty"` + // AllowPriceUpdates: If price updates are enabled, Google always updates the + // active price with the crawled information. + AllowPriceUpdates bool `json:"allowPriceUpdates,omitempty"` + // AllowStrictAvailabilityUpdates: If `allow_availability_updates` is enabled, + // items are automatically updated in all your Shopping target countries. By + // default, availability updates will only be applied to items that are 'out of + // stock' on your website but 'in stock' on Shopping. Set this to true to also + // update items that are 'in stock' on your website, but 'out of stock' on + // Google Shopping. In order for this field to have an effect, you must also + // set `allow_availability_updates`. + AllowStrictAvailabilityUpdates bool `json:"allowStrictAvailabilityUpdates,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowAvailabilityUpdates") + // 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. "AllowAvailabilityUpdates") 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 ItemUpdatesAccountLevelSettings) MarshalJSON() ([]byte, error) { + type NoMethod ItemUpdatesAccountLevelSettings + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListAccountIssuesResponse: Response message for the `ListAccountIssues` // method. type ListAccountIssuesResponse struct { @@ -1708,8 +1955,8 @@ type OnlineReturnPolicy struct { // Countries: Required. Immutable. The countries of sale where the return // policy applies. The values must be a valid 2 letter ISO 3166 code. Countries []string `json:"countries,omitempty"` - // ItemConditions: The item conditions accepted for returns must not be empty - // unless the type of return policy is 'noReturns'. + // ItemConditions: Optional. The item conditions accepted for returns must not + // be empty unless the type of return policy is 'noReturns'. // // Possible values: // "ITEM_CONDITION_UNSPECIFIED" - Default value. This value is unused. @@ -1728,18 +1975,18 @@ type OnlineReturnPolicy struct { // Name: Identifier. The name of the `OnlineReturnPolicy` resource. Format: // `accounts/{account}/onlineReturnPolicies/{return_policy}` Name string `json:"name,omitempty"` - // Policy: The return policy. + // Policy: Optional. The return policy. Policy *Policy `json:"policy,omitempty"` // ProcessRefundDays: The field specifies the number of days it takes for // merchants to process refunds, field is optional. ProcessRefundDays int64 `json:"processRefundDays,omitempty"` - // RestockingFee: The restocking fee that applies to all return reason - // categories. This would be treated as a free restocking fee if the value is - // not set. + // RestockingFee: Optional. The restocking fee that applies to all return + // reason categories. This would be treated as a free restocking fee if the + // value is not set. RestockingFee *RestockingFee `json:"restockingFee,omitempty"` - // ReturnMethods: The return methods of how customers can return an item. This - // value is required to not be empty unless the type of return policy is - // noReturns. + // ReturnMethods: Optional. The return methods of how customers can return an + // item. This value is required to not be empty unless the type of return + // policy is noReturns. // // Possible values: // "RETURN_METHOD_UNSPECIFIED" - Default value. This value is unused. @@ -1752,8 +1999,8 @@ type OnlineReturnPolicy struct { // ReturnPolicyUri: Required. The return policy uri. This can used by Google to // do a sanity check for the policy. It must be a valid URL. ReturnPolicyUri string `json:"returnPolicyUri,omitempty"` - // ReturnShippingFee: The return shipping fee. Should be set only when customer - // need to download and print the return label. + // ReturnShippingFee: Optional. The return shipping fee. Should be set only + // when customer need to download and print the return label. ReturnShippingFee *ReturnShippingFee `json:"returnShippingFee,omitempty"` // SeasonalOverrides: Optional. Overrides to the general policy for orders // placed during a specific set of time intervals. @@ -2147,7 +2394,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. @@ -2471,28 +2720,26 @@ func (s Row) MarshalJSON() ([]byte, error) { } type SeasonalOverride struct { - // Begin: Required. Defines the date range when this seasonal override applies. - // Both begin and end are inclusive and should be in date decimal format, - // example 20250115. The dates of the seasonal overrides should not overlap. - Begin *Date `json:"begin,omitempty"` - // End: Required. seasonal override end date (inclusive). - End *Date `json:"end,omitempty"` + // EndDate: Required. seasonal override end date (inclusive). + EndDate *Date `json:"endDate,omitempty"` // Label: Required. Display name of this seasonal override in Merchant Center. Label string `json:"label,omitempty"` - // Policy: The return policy for the given date range. - Policy *Policy `json:"policy,omitempty"` // ReturnDays: Number of days (from the delivery date) that the product can be // returned. ReturnDays int64 `json:"returnDays,omitempty"` // ReturnUntilDate: Fixed end date until which the product can be returned. ReturnUntilDate *Date `json:"returnUntilDate,omitempty"` - // ForceSendFields is a list of field names (e.g. "Begin") to unconditionally + // StartDate: Required. Defines the date range when this seasonal override + // applies. Both start_date and end_date are inclusive. The dates of the + // seasonal overrides should not overlap. + StartDate *Date `json:"startDate,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndDate") 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. "Begin") to include in API + // NullFields is a list of field names (e.g. "EndDate") 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. @@ -3508,6 +3755,118 @@ func (c *AccountsGetCall) Do(opts ...googleapi.CallOption) (*Account, error) { return ret, nil } +type AccountsGetAutomaticImprovementsCall struct { + s *APIService + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAutomaticImprovements: Retrieves the automatic improvements of an +// account. +// +// - name: The resource name of the automatic improvements. Format: +// `accounts/{account}/automaticImprovements`. +func (r *AccountsService) GetAutomaticImprovements(name string) *AccountsGetAutomaticImprovementsCall { + c := &AccountsGetAutomaticImprovementsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsGetAutomaticImprovementsCall) Fields(s ...googleapi.Field) *AccountsGetAutomaticImprovementsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountsGetAutomaticImprovementsCall) IfNoneMatch(entityTag string) *AccountsGetAutomaticImprovementsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsGetAutomaticImprovementsCall) Context(ctx context.Context) *AccountsGetAutomaticImprovementsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsGetAutomaticImprovementsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsGetAutomaticImprovementsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/v1beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "merchantapi.accounts.getAutomaticImprovements", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "merchantapi.accounts.getAutomaticImprovements" call. +// Any non-2xx status code is an error. Response headers are in either +// *AutomaticImprovements.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountsGetAutomaticImprovementsCall) Do(opts ...googleapi.CallOption) (*AutomaticImprovements, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &AutomaticImprovements{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "merchantapi.accounts.getAutomaticImprovements", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type AccountsListCall struct { s *APIService urlParams_ gensupport.URLParams @@ -3938,6 +4297,123 @@ func (c *AccountsPatchCall) Do(opts ...googleapi.CallOption) (*Account, error) { return ret, nil } +type AccountsUpdateAutomaticImprovementsCall struct { + s *APIService + name string + automaticimprovements *AutomaticImprovements + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateAutomaticImprovements: Updates the automatic improvements of an +// account. +// +// - name: Identifier. The resource name of the automatic improvements. Format: +// `accounts/{account}/automaticImprovements`. +func (r *AccountsService) UpdateAutomaticImprovements(name string, automaticimprovements *AutomaticImprovements) *AccountsUpdateAutomaticImprovementsCall { + c := &AccountsUpdateAutomaticImprovementsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.automaticimprovements = automaticimprovements + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. List of +// fields being updated. The following fields are supported (in both +// `snake_case` and `lowerCamelCase`): - `item_updates` - +// `item_updates.account_level_settings` - `image_improvements` - +// `image_improvements.account_level_settings` - `shipping_improvements` - +// `shipping_improvements.allow_shipping_improvements` +func (c *AccountsUpdateAutomaticImprovementsCall) UpdateMask(updateMask string) *AccountsUpdateAutomaticImprovementsCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsUpdateAutomaticImprovementsCall) Fields(s ...googleapi.Field) *AccountsUpdateAutomaticImprovementsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsUpdateAutomaticImprovementsCall) Context(ctx context.Context) *AccountsUpdateAutomaticImprovementsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsUpdateAutomaticImprovementsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsUpdateAutomaticImprovementsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.automaticimprovements) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/v1beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "merchantapi.accounts.updateAutomaticImprovements", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "merchantapi.accounts.updateAutomaticImprovements" call. +// Any non-2xx status code is an error. Response headers are in either +// *AutomaticImprovements.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountsUpdateAutomaticImprovementsCall) Do(opts ...googleapi.CallOption) (*AutomaticImprovements, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &AutomaticImprovements{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "merchantapi.accounts.updateAutomaticImprovements", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type AccountsAutofeedSettingsGetAutofeedSettingsCall struct { s *APIService name string diff --git a/merchantapi/conversions_v1beta/merchantapi-api.json b/merchantapi/conversions_v1beta/merchantapi-api.json index 052fa8b013..572f9314b8 100644 --- a/merchantapi/conversions_v1beta/merchantapi-api.json +++ b/merchantapi/conversions_v1beta/merchantapi-api.json @@ -295,7 +295,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "AttributionSettings": { @@ -599,7 +599,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/conversions_v1beta/merchantapi-gen.go b/merchantapi/conversions_v1beta/merchantapi-gen.go index 3f4df029cd..9976e0d64e 100644 --- a/merchantapi/conversions_v1beta/merchantapi-gen.go +++ b/merchantapi/conversions_v1beta/merchantapi-gen.go @@ -494,7 +494,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/datasources_v1beta/merchantapi-api.json b/merchantapi/datasources_v1beta/merchantapi-api.json index 4ca0de9f9d..44e07fd455 100644 --- a/merchantapi/datasources_v1beta/merchantapi-api.json +++ b/merchantapi/datasources_v1beta/merchantapi-api.json @@ -321,7 +321,7 @@ } } }, - "revision": "20250301", + "revision": "20250312", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "DataSource": { @@ -429,6 +429,61 @@ }, "type": "object" }, + "Destination": { + "description": "Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections.", + "id": "Destination", + "properties": { + "destination": { + "description": "[Marketing methods](https://support.google.com/merchants/answer/15130232) (also known as destination) selections.", + "enum": [ + "DESTINATION_ENUM_UNSPECIFIED", + "SHOPPING_ADS", + "DISPLAY_ADS", + "LOCAL_INVENTORY_ADS", + "FREE_LISTINGS", + "FREE_LOCAL_LISTINGS", + "YOUTUBE_SHOPPING", + "YOUTUBE_SHOPPING_CHECKOUT", + "YOUTUBE_AFFILIATE", + "FREE_VEHICLE_LISTINGS", + "VEHICLE_ADS", + "CLOUD_RETAIL", + "LOCAL_CLOUD_RETAIL" + ], + "enumDescriptions": [ + "Not specified.", + "[Shopping ads](https://support.google.com/google-ads/answer/2454022).", + "[Display ads](https://support.google.com/merchants/answer/6069387).", + "[Local inventory ads](https://support.google.com/merchants/answer/3057972).", + "[Free listings](https://support.google.com/merchants/answer/9199328).", + "[Free local product listings](https://support.google.com/merchants/answer/9825611).", + "[YouTube Shopping](https://support.google.com/merchants/answer/12362804).", + "Youtube shopping checkout.", + "[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).", + "[Free vehicle listings](https://support.google.com/merchants/answer/11189169).", + "[Vehicle ads](https://support.google.com/merchants/answer/11189169).", + "[Cloud retail](https://cloud.google.com/solutions/retail).", + "[Local cloud retail](https://cloud.google.com/solutions/retail)." + ], + "type": "string" + }, + "state": { + "description": "The state of the destination.", + "enum": [ + "STATE_UNSPECIFIED", + "ENABLED", + "DISABLED" + ], + "enumDescriptions": [ + "Not specified.", + "Indicates that the destination is enabled.", + "Indicates that the destination is disabled." + ], + "type": "string" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -737,6 +792,13 @@ "$ref": "DefaultRule", "description": "Optional. Default rule management of the data source. If set, the linked data sources will be replaced." }, + "destinations": { + "description": "Optional. A list of destinations describing where products of the data source can be shown. When retrieving the data source, the list contains all the destinations that can be used for the data source, including the ones that are disabled for the data source but enabled for the account. Only destinations that are enabled on the account, for example through program participation, can be enabled on the data source. If unset, during creation, the destinations will be inherited based on the account level program participation. If set, during creation or update, the data source will be set only for the specified destinations. Updating this field requires at least one destination.", + "items": { + "$ref": "Destination" + }, + "type": "array" + }, "feedLabel": { "description": "Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.", "type": "string" @@ -864,7 +926,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/datasources_v1beta/merchantapi-gen.go b/merchantapi/datasources_v1beta/merchantapi-gen.go index 2cea29e60e..43085d077f 100644 --- a/merchantapi/datasources_v1beta/merchantapi-gen.go +++ b/merchantapi/datasources_v1beta/merchantapi-gen.go @@ -328,6 +328,64 @@ func (s DefaultRule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Destination: Destinations also known as Marketing methods +// (https://support.google.com/merchants/answer/15130232) selections. +type Destination struct { + // Destination: Marketing methods + // (https://support.google.com/merchants/answer/15130232) (also known as + // destination) selections. + // + // Possible values: + // "DESTINATION_ENUM_UNSPECIFIED" - Not specified. + // "SHOPPING_ADS" - [Shopping + // ads](https://support.google.com/google-ads/answer/2454022). + // "DISPLAY_ADS" - [Display + // ads](https://support.google.com/merchants/answer/6069387). + // "LOCAL_INVENTORY_ADS" - [Local inventory + // ads](https://support.google.com/merchants/answer/3057972). + // "FREE_LISTINGS" - [Free + // listings](https://support.google.com/merchants/answer/9199328). + // "FREE_LOCAL_LISTINGS" - [Free local product + // listings](https://support.google.com/merchants/answer/9825611). + // "YOUTUBE_SHOPPING" - [YouTube + // Shopping](https://support.google.com/merchants/answer/12362804). + // "YOUTUBE_SHOPPING_CHECKOUT" - Youtube shopping checkout. + // "YOUTUBE_AFFILIATE" - [Youtube + // Affiliate](https://support.google.com/youtube/answer/13376398). + // "FREE_VEHICLE_LISTINGS" - [Free vehicle + // listings](https://support.google.com/merchants/answer/11189169). + // "VEHICLE_ADS" - [Vehicle + // ads](https://support.google.com/merchants/answer/11189169). + // "CLOUD_RETAIL" - [Cloud + // retail](https://cloud.google.com/solutions/retail). + // "LOCAL_CLOUD_RETAIL" - [Local cloud + // retail](https://cloud.google.com/solutions/retail). + Destination string `json:"destination,omitempty"` + // State: The state of the destination. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not specified. + // "ENABLED" - Indicates that the destination is enabled. + // "DISABLED" - Indicates that the destination is disabled. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Destination") 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. "Destination") 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 Destination) MarshalJSON() ([]byte, error) { + type NoMethod Destination + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -629,6 +687,17 @@ type PrimaryProductDataSource struct { // DefaultRule: Optional. Default rule management of the data source. If set, // the linked data sources will be replaced. DefaultRule *DefaultRule `json:"defaultRule,omitempty"` + // Destinations: Optional. A list of destinations describing where products of + // the data source can be shown. When retrieving the data source, the list + // contains all the destinations that can be used for the data source, + // including the ones that are disabled for the data source but enabled for the + // account. Only destinations that are enabled on the account, for example + // through program participation, can be enabled on the data source. If unset, + // during creation, the destinations will be inherited based on the account + // level program participation. If set, during creation or update, the data + // source will be set only for the specified destinations. Updating this field + // requires at least one destination. + Destinations []*Destination `json:"destinations,omitempty"` // FeedLabel: Optional. Immutable. The feed label that is specified on the data // source level. Must be less than or equal to 20 uppercase letters (A-Z), // numbers (0-9), and dashes (-). See also migration to feed labels @@ -752,7 +821,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/inventories_v1beta/merchantapi-api.json b/merchantapi/inventories_v1beta/merchantapi-api.json index b258adee9a..d824b814b2 100644 --- a/merchantapi/inventories_v1beta/merchantapi-api.json +++ b/merchantapi/inventories_v1beta/merchantapi-api.json @@ -300,7 +300,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "CustomAttribute": { @@ -576,7 +576,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/inventories_v1beta/merchantapi-gen.go b/merchantapi/inventories_v1beta/merchantapi-gen.go index 1389071369..bcb09bbac0 100644 --- a/merchantapi/inventories_v1beta/merchantapi-gen.go +++ b/merchantapi/inventories_v1beta/merchantapi-gen.go @@ -518,7 +518,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/lfp_v1beta/merchantapi-api.json b/merchantapi/lfp_v1beta/merchantapi-api.json index 0c14558254..2596ffdbc9 100644 --- a/merchantapi/lfp_v1beta/merchantapi-api.json +++ b/merchantapi/lfp_v1beta/merchantapi-api.json @@ -298,7 +298,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Empty": { @@ -650,7 +650,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/lfp_v1beta/merchantapi-gen.go b/merchantapi/lfp_v1beta/merchantapi-gen.go index 067c640cd1..3b0ab77852 100644 --- a/merchantapi/lfp_v1beta/merchantapi-gen.go +++ b/merchantapi/lfp_v1beta/merchantapi-gen.go @@ -567,7 +567,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/notifications_v1beta/merchantapi-api.json b/merchantapi/notifications_v1beta/merchantapi-api.json index 17b0acc40d..974cbc9c61 100644 --- a/merchantapi/notifications_v1beta/merchantapi-api.json +++ b/merchantapi/notifications_v1beta/merchantapi-api.json @@ -262,7 +262,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Empty": { @@ -439,7 +439,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/notifications_v1beta/merchantapi-gen.go b/merchantapi/notifications_v1beta/merchantapi-gen.go index f9da1f9141..419b4ed201 100644 --- a/merchantapi/notifications_v1beta/merchantapi-gen.go +++ b/merchantapi/notifications_v1beta/merchantapi-gen.go @@ -354,7 +354,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/products_v1beta/merchantapi-api.json b/merchantapi/products_v1beta/merchantapi-api.json index 5c8e69d48f..65156d7905 100644 --- a/merchantapi/products_v1beta/merchantapi-api.json +++ b/merchantapi/products_v1beta/merchantapi-api.json @@ -171,6 +171,45 @@ "scopes": [ "https://www.googleapis.com/auth/content" ] + }, + "patch": { + "description": "Updates the existing product input in your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.", + "flatPath": "products/v1beta/accounts/{accountsId}/productInputs/{productInputsId}", + "httpMethod": "PATCH", + "id": "merchantapi.accounts.productInputs.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "dataSource": { + "description": "Required. The primary or supplemental product data source where `data_source` name identifies the product input to be updated. Only API data sources are supported. Format: `accounts/{account}/dataSources/{datasource}`.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Identifier. The name of the product input. Format: `\"{productinput.name=accounts/{account}/productInputs/{productinput}}\"` where the last section `productinput` consists of 4 parts: channel~content_language~feed_label~offer_id example for product input name is \"accounts/123/productInputs/online~en~US~sku123\"", + "location": "path", + "pattern": "^accounts/[^/]+/productInputs/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of product attributes to be updated. If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value). Attributes specified in the update mask without a value specified in the body will be deleted from the product. Update mask can only be specified for top level fields in attributes and custom attributes. To specify the update mask for custom attributes you need to add the `custom_attribute.` prefix. Providing special \"*\" value for full product replacement is not supported.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "products/v1beta/{+name}", + "request": { + "$ref": "ProductInput" + }, + "response": { + "$ref": "ProductInput" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] } } }, @@ -242,7 +281,7 @@ } } }, - "revision": "20250301", + "revision": "20250317", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Attributes": { @@ -1471,7 +1510,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/products_v1beta/merchantapi-gen.go b/merchantapi/products_v1beta/merchantapi-gen.go index 0164e1d171..b13b6c05fc 100644 --- a/merchantapi/products_v1beta/merchantapi-gen.go +++ b/merchantapi/products_v1beta/merchantapi-gen.go @@ -1375,7 +1375,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. @@ -2083,6 +2085,138 @@ func (c *AccountsProductInputsInsertCall) Do(opts ...googleapi.CallOption) (*Pro return ret, nil } +type AccountsProductInputsPatchCall struct { + s *Service + name string + productinput *ProductInput + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the existing product input in your Merchant Center account. +// After inserting, updating, or deleting a product input, it may take several +// minutes before the processed product can be retrieved. +// +// - name: Identifier. The name of the product input. Format: +// "{productinput.name=accounts/{account}/productInputs/{productinput}}" +// where the last section `productinput` consists of 4 parts: +// channel~content_language~feed_label~offer_id example for product input +// name is "accounts/123/productInputs/online~en~US~sku123". +func (r *AccountsProductInputsService) Patch(name string, productinput *ProductInput) *AccountsProductInputsPatchCall { + c := &AccountsProductInputsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.productinput = productinput + return c +} + +// DataSource sets the optional parameter "dataSource": Required. The primary +// or supplemental product data source where `data_source` name identifies the +// product input to be updated. Only API data sources are supported. Format: +// `accounts/{account}/dataSources/{datasource}`. +func (c *AccountsProductInputsPatchCall) DataSource(dataSource string) *AccountsProductInputsPatchCall { + c.urlParams_.Set("dataSource", dataSource) + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of product +// attributes to be updated. If the update mask is omitted, then it is treated +// as implied field mask equivalent to all fields that are populated (have a +// non-empty value). Attributes specified in the update mask without a value +// specified in the body will be deleted from the product. Update mask can only +// be specified for top level fields in attributes and custom attributes. To +// specify the update mask for custom attributes you need to add the +// `custom_attribute.` prefix. Providing special "*" value for full product +// replacement is not supported. +func (c *AccountsProductInputsPatchCall) UpdateMask(updateMask string) *AccountsProductInputsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsProductInputsPatchCall) Fields(s ...googleapi.Field) *AccountsProductInputsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsProductInputsPatchCall) Context(ctx context.Context) *AccountsProductInputsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsProductInputsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsProductInputsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.productinput) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "products/v1beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "merchantapi.accounts.productInputs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "merchantapi.accounts.productInputs.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *ProductInput.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountsProductInputsPatchCall) Do(opts ...googleapi.CallOption) (*ProductInput, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ProductInput{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "merchantapi.accounts.productInputs.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type AccountsProductsGetCall struct { s *Service name string diff --git a/merchantapi/promotions_v1beta/merchantapi-api.json b/merchantapi/promotions_v1beta/merchantapi-api.json index fd15729e70..6c56357261 100644 --- a/merchantapi/promotions_v1beta/merchantapi-api.json +++ b/merchantapi/promotions_v1beta/merchantapi-api.json @@ -203,7 +203,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Attributes": { @@ -890,7 +890,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/promotions_v1beta/merchantapi-gen.go b/merchantapi/promotions_v1beta/merchantapi-gen.go index 95aaca886b..34d08eaa51 100644 --- a/merchantapi/promotions_v1beta/merchantapi-gen.go +++ b/merchantapi/promotions_v1beta/merchantapi-gen.go @@ -824,7 +824,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/quota_v1beta/merchantapi-api.json b/merchantapi/quota_v1beta/merchantapi-api.json index 548a222544..11090acb3a 100644 --- a/merchantapi/quota_v1beta/merchantapi-api.json +++ b/merchantapi/quota_v1beta/merchantapi-api.json @@ -150,7 +150,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "ListQuotaGroupsResponse": { @@ -312,7 +312,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/quota_v1beta/merchantapi-gen.go b/merchantapi/quota_v1beta/merchantapi-gen.go index 557053b52d..baf11f8b58 100644 --- a/merchantapi/quota_v1beta/merchantapi-gen.go +++ b/merchantapi/quota_v1beta/merchantapi-gen.go @@ -327,7 +327,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/reports_v1beta/merchantapi-api.json b/merchantapi/reports_v1beta/merchantapi-api.json index 999eeda69f..afe4551041 100644 --- a/merchantapi/reports_v1beta/merchantapi-api.json +++ b/merchantapi/reports_v1beta/merchantapi-api.json @@ -142,7 +142,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "BestSellersBrandView": { @@ -1250,7 +1250,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/reports_v1beta/merchantapi-gen.go b/merchantapi/reports_v1beta/merchantapi-gen.go index 7a574c42aa..150e69a383 100644 --- a/merchantapi/reports_v1beta/merchantapi-gen.go +++ b/merchantapi/reports_v1beta/merchantapi-gen.go @@ -1383,7 +1383,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/merchantapi/reviews_v1beta/merchantapi-api.json b/merchantapi/reviews_v1beta/merchantapi-api.json index 17b44b91c1..65e17eb51d 100644 --- a/merchantapi/reviews_v1beta/merchantapi-api.json +++ b/merchantapi/reviews_v1beta/merchantapi-api.json @@ -356,7 +356,7 @@ } } }, - "revision": "20250301", + "revision": "20250311", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "CustomAttribute": { @@ -432,7 +432,7 @@ "description": "Optional. A list of merchant review attributes." }, "customAttributes": { - "description": "Required. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API, such as experimental attributes. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.", + "description": "Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API, such as experimental attributes. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.", "items": { "$ref": "CustomAttribute" }, @@ -523,7 +523,7 @@ "type": "string" }, "reviewLanguage": { - "description": "Required. The language of the review defined by BCP-47 language code.", + "description": "Optional. The language of the review defined by BCP-47 language code.", "type": "string" }, "reviewTime": { @@ -1323,7 +1323,7 @@ "type": "array" }, "eventTime": { - "description": "The time at which the event was generated.", + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", "format": "google-datetime", "type": "string" }, diff --git a/merchantapi/reviews_v1beta/merchantapi-gen.go b/merchantapi/reviews_v1beta/merchantapi-gen.go index 4607f804e9..bd3dcc8c8a 100644 --- a/merchantapi/reviews_v1beta/merchantapi-gen.go +++ b/merchantapi/reviews_v1beta/merchantapi-gen.go @@ -290,7 +290,7 @@ func (s ListProductReviewsResponse) MarshalJSON() ([]byte, error) { type MerchantReview struct { // Attributes: Optional. A list of merchant review attributes. Attributes *MerchantReviewAttributes `json:"attributes,omitempty"` - // CustomAttributes: Required. A list of custom (merchant-provided) attributes. + // CustomAttributes: Optional. A list of custom (merchant-provided) attributes. // It can also be used for submitting any attribute of the data specification // in its generic form (for example, `{ "name": "size type", "value": "regular" // }`). This is useful for submitting attributes not explicitly exposed by the @@ -378,7 +378,7 @@ type MerchantReviewAttributes struct { // ReviewCountry: Optional. The country where the reviewer made the order // defined by ISO 3166-1 Alpha-2 Country Code. ReviewCountry string `json:"reviewCountry,omitempty"` - // ReviewLanguage: Required. The language of the review defined by BCP-47 + // ReviewLanguage: Optional. The language of the review defined by BCP-47 // language code. ReviewLanguage string `json:"reviewLanguage,omitempty"` // ReviewTime: Required. The timestamp indicating when the review was written. @@ -1039,7 +1039,9 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` - // EventTime: The time at which the event was generated. + // EventTime: The time at which the event was generated. If you want to order + // the notification messages you receive you should rely on this field not on + // the order of receiving the notifications. EventTime string `json:"eventTime,omitempty"` // ExpirationTime: Optional. The product expiration time. This field will not // bet set if the notification is sent for a product deletion event. diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 0a6b1eaf1c..98bab02e9b 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -1831,7 +1831,7 @@ ], "parameters": { "name": { - "description": "Output only. Name of the preference set.", + "description": "Output only. Name of the PreferenceSet.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/preferenceSets/[^/]+$", "required": true, @@ -2548,7 +2548,7 @@ } } }, - "revision": "20250220", + "revision": "20250312", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -7100,7 +7100,7 @@ "type": "string" }, "name": { - "description": "Output only. Name of the preference set.", + "description": "Output only. Name of the PreferenceSet.", "readOnly": true, "type": "string" }, diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index 5c164c70d4..0dd53295d7 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -5526,7 +5526,7 @@ type PreferenceSet struct { Description string `json:"description,omitempty"` // DisplayName: User-friendly display name. Maximum length is 63 characters. DisplayName string `json:"displayName,omitempty"` - // Name: Output only. Name of the preference set. + // Name: Output only. Name of the PreferenceSet. Name string `json:"name,omitempty"` // RegionPreferences: Optional. Region preferences for assets using this // preference set. If you are unsure which value to set, the migration service @@ -13879,7 +13879,7 @@ type ProjectsLocationsPreferenceSetsPatchCall struct { // Patch: Updates the parameters of a preference set. // -// - name: Output only. Name of the preference set. +// - name: Output only. Name of the PreferenceSet. func (r *ProjectsLocationsPreferenceSetsService) Patch(name string, preferenceset *PreferenceSet) *ProjectsLocationsPreferenceSetsPatchCall { c := &ProjectsLocationsPreferenceSetsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index 549c4f5c30..b0545572fd 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-api.json @@ -1589,7 +1589,7 @@ "type": "string" }, "regionalEndpointId": { - "description": "Required. Unique id of the Regional Endpoint to be created.", + "description": "Required. Unique id of the Regional Endpoint to be created. @pattern: ^[-a-z0-9](?:[-a-z0-9]{0,44})[a-z0-9]$", "location": "query", "type": "string" }, @@ -2919,7 +2919,7 @@ } } }, - "revision": "20250226", + "revision": "20250305", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AcceptHubSpokeRequest": { @@ -4849,7 +4849,7 @@ "type": "object" }, "name": { - "description": "Output only. The name of a RegionalEndpoint. Format: `projects/{project}/locations/{location}/regionalEndpoints/{regional_endpoint}`.", + "description": "Output only. The name of a RegionalEndpoint. Pattern: `projects/{project}/locations/{location}/regionalEndpoints/^[-a-z0-9](?:[-a-z0-9]{0,44})[a-z0-9]$`.", "readOnly": true, "type": "string" }, diff --git a/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index 809bff1de5..e364470e22 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -2734,9 +2734,9 @@ type RegionalEndpoint struct { IpAddress string `json:"ipAddress,omitempty"` // Labels: User-defined labels. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The name of a RegionalEndpoint. Format: - // `projects/{project}/locations/{location}/regionalEndpoints/{regional_endpoint - // }`. + // Name: Output only. The name of a RegionalEndpoint. Pattern: + // `projects/{project}/locations/{location}/regionalEndpoints/^-a-z0-9 + // (?:[-a-z0-9]{0,44})[a-z0-9]$`. Name string `json:"name,omitempty"` // Network: The name of the VPC network for this private regional endpoint. // Format: `projects/{project}/global/networks/{network}` @@ -9078,7 +9078,8 @@ func (r *ProjectsLocationsRegionalEndpointsService) Create(parent string, region } // RegionalEndpointId sets the optional parameter "regionalEndpointId": -// Required. Unique id of the Regional Endpoint to be created. +// Required. Unique id of the Regional Endpoint to be created. @pattern: +// ^-a-z0-9 (?:[-a-z0-9]{0,44})[a-z0-9]$ func (c *ProjectsLocationsRegionalEndpointsCreateCall) RegionalEndpointId(regionalEndpointId string) *ProjectsLocationsRegionalEndpointsCreateCall { c.urlParams_.Set("regionalEndpointId", regionalEndpointId) return c diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index 7905156f7c..e0d6d0f11c 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -758,7 +758,7 @@ } } }, - "revision": "20250226", + "revision": "20250305", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -1321,6 +1321,7 @@ "FORWARDING_RULE_MISMATCH", "FORWARDING_RULE_NO_INSTANCES", "FIREWALL_BLOCKING_LOAD_BALANCER_BACKEND_HEALTH_CHECK", + "INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS", "INSTANCE_NOT_RUNNING", "GKE_CLUSTER_NOT_RUNNING", "CLOUD_SQL_INSTANCE_NOT_RUNNING", @@ -1407,6 +1408,7 @@ "Forwarding rule's protocol and ports do not match the packet header.", "Forwarding rule does not have backends configured.", "Firewalls block the health check probes to the backends and cause the backends to be unavailable for traffic from the load balancer. For more details, see [Health check firewall rules](https://cloud.google.com/load-balancing/docs/health-checks#firewall_rules).", + "Matching ingress firewall rules by network tags for packets sent via serverless VPC direct egress is unsupported. Behavior is undefined. https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations", "Packet is sent from or to a Compute Engine instance that is not in a running state.", "Packet sent from or to a GKE cluster that is not in running state.", "Packet sent from or to a Cloud SQL instance that is not in running state.", diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index 76ac638eda..50b6270f65 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -963,6 +963,10 @@ type DropInfo struct { // [Health check firewall // rules](https://cloud.google.com/load-balancing/docs/health-checks#firewall_ru // les). + // "INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS" - Matching + // ingress firewall rules by network tags for packets sent via serverless VPC + // direct egress is unsupported. Behavior is undefined. + // https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations // "INSTANCE_NOT_RUNNING" - Packet is sent from or to a Compute Engine // instance that is not in a running state. // "GKE_CLUSTER_NOT_RUNNING" - Packet sent from or to a GKE cluster that is diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index a2a10c0f9d..37a39ab01a 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -961,7 +961,7 @@ } } }, - "revision": "20250226", + "revision": "20250305", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -1524,6 +1524,7 @@ "FORWARDING_RULE_MISMATCH", "FORWARDING_RULE_NO_INSTANCES", "FIREWALL_BLOCKING_LOAD_BALANCER_BACKEND_HEALTH_CHECK", + "INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS", "INSTANCE_NOT_RUNNING", "GKE_CLUSTER_NOT_RUNNING", "CLOUD_SQL_INSTANCE_NOT_RUNNING", @@ -1610,6 +1611,7 @@ "Forwarding rule's protocol and ports do not match the packet header.", "Forwarding rule does not have backends configured.", "Firewalls block the health check probes to the backends and cause the backends to be unavailable for traffic from the load balancer. For more details, see [Health check firewall rules](https://cloud.google.com/load-balancing/docs/health-checks#firewall_rules).", + "Matching ingress firewall rules by network tags for packets sent via serverless VPC direct egress is unsupported. Behavior is undefined. https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations", "Packet is sent from or to a Compute Engine instance that is not in a running state.", "Packet sent from or to a GKE cluster that is not in running state.", "Packet sent from or to a Cloud SQL instance that is not in running state.", diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index 74e90c6943..07434e7262 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -1011,6 +1011,10 @@ type DropInfo struct { // [Health check firewall // rules](https://cloud.google.com/load-balancing/docs/health-checks#firewall_ru // les). + // "INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS" - Matching + // ingress firewall rules by network tags for packets sent via serverless VPC + // direct egress is unsupported. Behavior is undefined. + // https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations // "INSTANCE_NOT_RUNNING" - Packet is sent from or to a Compute Engine // instance that is not in a running state. // "GKE_CLUSTER_NOT_RUNNING" - Packet sent from or to a GKE cluster that is diff --git a/networksecurity/v1/networksecurity-api.json b/networksecurity/v1/networksecurity-api.json index 22998f6516..baeabf7e26 100644 --- a/networksecurity/v1/networksecurity-api.json +++ b/networksecurity/v1/networksecurity-api.json @@ -3743,6 +3743,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. Setting this field to `true` will opt the request into returning the resources that are reachable, and into including the names of those that were unreachable in the [ListServerTlsPoliciesResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`.", + "location": "query", + "type": "boolean" } }, "path": "v1/{+parent}/serverTlsPolicies", @@ -4169,7 +4174,7 @@ } } }, - "revision": "20250217", + "revision": "20250310", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -5717,6 +5722,13 @@ "$ref": "ServerTlsPolicy" }, "type": "array" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request opts into `return_partial_success` and reading across collections e.g. when attempting to list all resources across all supported locations.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -5934,11 +5946,20 @@ "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, + "locations": { + "description": "Output only. The list of locations where the deployment group is present.", + "items": { + "$ref": "MirroringLocation" + }, + "readOnly": true, + "type": "array" + }, "name": { "description": "Immutable. Identifier. The resource name of this deployment group, for example: `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See https://google.aip.dev/122 for more details.", "type": "string" }, "nestedDeployments": { + "deprecated": true, "description": "Output only. The list of Mirroring Deployments that belong to this group.", "items": { "$ref": "MirroringDeploymentGroupDeployment" @@ -6038,6 +6059,14 @@ "readOnly": true, "type": "array" }, + "connectedDeploymentGroups": { + "description": "Output only. List of details about the connected deployment groups to this endpoint group.", + "items": { + "$ref": "MirroringEndpointGroupConnectedDeploymentGroup" + }, + "readOnly": true, + "type": "array" + }, "createTime": { "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", @@ -6117,7 +6146,16 @@ "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, + "locations": { + "description": "Output only. The list of locations where the association is configured. This information is retrieved from the linked endpoint group.", + "items": { + "$ref": "MirroringLocation" + }, + "readOnly": true, + "type": "array" + }, "locationsDetails": { + "deprecated": true, "description": "Output only. The list of locations where the association is present. This information is retrieved from the linked endpoint group, and not configured as part of the association itself.", "items": { "$ref": "MirroringEndpointGroupAssociationLocationDetails" @@ -6241,6 +6279,53 @@ }, "type": "object" }, + "MirroringEndpointGroupConnectedDeploymentGroup": { + "description": "The endpoint group's view of a connected deployment group.", + "id": "MirroringEndpointGroupConnectedDeploymentGroup", + "properties": { + "locations": { + "description": "Output only. The list of locations where the deployment group is present.", + "items": { + "$ref": "MirroringLocation" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The connected deployment group's resource name, for example: `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See https://google.aip.dev/124.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "MirroringLocation": { + "description": "Details about mirroring in a specific cloud location.", + "id": "MirroringLocation", + "properties": { + "location": { + "description": "Output only. The cloud location, e.g. \"us-central1-a\" or \"asia-south1\".", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of the association in this location.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "OUT_OF_SYNC" + ], + "enumDescriptions": [ + "State not set (this is not a valid state).", + "The resource is ready and in sync in the location.", + "The resource is out of sync in the location. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", diff --git a/networksecurity/v1/networksecurity-gen.go b/networksecurity/v1/networksecurity-gen.go index 6b93f674e1..243a3166f8 100644 --- a/networksecurity/v1/networksecurity-gen.go +++ b/networksecurity/v1/networksecurity-gen.go @@ -2626,6 +2626,10 @@ type ListServerTlsPoliciesResponse struct { NextPageToken string `json:"nextPageToken,omitempty"` // ServerTlsPolicies: List of ServerTlsPolicy resources. ServerTlsPolicies []*ServerTlsPolicy `json:"serverTlsPolicies,omitempty"` + // Unreachable: Unreachable resources. Populated when the request opts into + // `return_partial_success` and reading across collections e.g. when attempting + // to list all resources across all supported locations. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2891,6 +2895,9 @@ type MirroringDeploymentGroup struct { // Labels: Optional. Labels are key/value pairs that help to organize and // filter resources. Labels map[string]string `json:"labels,omitempty"` + // Locations: Output only. The list of locations where the deployment group is + // present. + Locations []*MirroringLocation `json:"locations,omitempty"` // Name: Immutable. Identifier. The resource name of this deployment group, for // example: // `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See @@ -3015,6 +3022,9 @@ func (s MirroringDeploymentGroupDeployment) MarshalJSON() ([]byte, error) { type MirroringEndpointGroup struct { // Associations: Output only. List of associations to this endpoint group. Associations []*MirroringEndpointGroupAssociationDetails `json:"associations,omitempty"` + // ConnectedDeploymentGroups: Output only. List of details about the connected + // deployment groups to this endpoint group. + ConnectedDeploymentGroups []*MirroringEndpointGroupConnectedDeploymentGroup `json:"connectedDeploymentGroups,omitempty"` // CreateTime: Output only. The timestamp when the resource was created. See // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` @@ -3097,6 +3107,9 @@ type MirroringEndpointGroupAssociation struct { // Labels: Optional. Labels are key/value pairs that help to organize and // filter resources. Labels map[string]string `json:"labels,omitempty"` + // Locations: Output only. The list of locations where the association is + // configured. This information is retrieved from the linked endpoint group. + Locations []*MirroringLocation `json:"locations,omitempty"` // LocationsDetails: Output only. The list of locations where the association // is present. This information is retrieved from the linked endpoint group, // and not configured as part of the association itself. @@ -3246,6 +3259,67 @@ func (s MirroringEndpointGroupAssociationLocationDetails) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// MirroringEndpointGroupConnectedDeploymentGroup: The endpoint group's view of +// a connected deployment group. +type MirroringEndpointGroupConnectedDeploymentGroup struct { + // Locations: Output only. The list of locations where the deployment group is + // present. + Locations []*MirroringLocation `json:"locations,omitempty"` + // Name: Output only. The connected deployment group's resource name, for + // example: + // `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See + // https://google.aip.dev/124. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 MirroringEndpointGroupConnectedDeploymentGroup) MarshalJSON() ([]byte, error) { + type NoMethod MirroringEndpointGroupConnectedDeploymentGroup + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// MirroringLocation: Details about mirroring in a specific cloud location. +type MirroringLocation struct { + // Location: Output only. The cloud location, e.g. "us-central1-a" or + // "asia-south1". + Location string `json:"location,omitempty"` + // State: Output only. The current state of the association in this location. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The resource is ready and in sync in the location. + // "OUT_OF_SYNC" - The resource is out of sync in the location. In most + // cases, this is a result of a transient issue within the system (e.g. an + // inaccessible location) and the system is expected to recover automatically. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") 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. "Location") 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 MirroringLocation) MarshalJSON() ([]byte, error) { + type NoMethod MirroringLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is the // result of a network API call. type Operation struct { @@ -17221,6 +17295,17 @@ func (c *ProjectsLocationsServerTlsPoliciesListCall) PageToken(pageToken string) return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Setting this field to `true` will opt the request into returning the +// resources that are reachable, and into including the names of those that +// were unreachable in the [ListServerTlsPoliciesResponse.unreachable] field. +// This can only be `true` when reading across collections e.g. when `parent` +// is set to "projects/example/locations/-". +func (c *ProjectsLocationsServerTlsPoliciesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsServerTlsPoliciesListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + 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/networksecurity/v1beta1/networksecurity-api.json b/networksecurity/v1beta1/networksecurity-api.json index 1c85bec6f7..13b41408a2 100644 --- a/networksecurity/v1beta1/networksecurity-api.json +++ b/networksecurity/v1beta1/networksecurity-api.json @@ -4633,6 +4633,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. Setting this field to `true` will opt the request into returning the resources that are reachable, and into including the names of those that were unreachable in the [ListServerTlsPoliciesResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`.", + "location": "query", + "type": "boolean" } }, "path": "v1beta1/{+parent}/serverTlsPolicies", @@ -5059,7 +5064,7 @@ } } }, - "revision": "20250217", + "revision": "20250310", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -6294,7 +6299,7 @@ "type": "string" }, "forwardingRule": { - "description": "Required. Immutable. The regional forwarding rule that fronts the intercept collectors, for example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`. See https://google.aip.dev/124.", + "description": "Required. Immutable. The regional forwarding rule that fronts the interceptors, for example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`. See https://google.aip.dev/124.", "type": "string" }, "interceptDeploymentGroup": { @@ -6376,11 +6381,20 @@ "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, + "locations": { + "description": "Output only. The list of locations where the deployment group is present.", + "items": { + "$ref": "InterceptLocation" + }, + "readOnly": true, + "type": "array" + }, "name": { "description": "Immutable. Identifier. The resource name of this deployment group, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/122 for more details.", "type": "string" }, "nestedDeployments": { + "deprecated": true, "description": "Output only. The list of Intercept Deployments that belong to this group.", "items": { "$ref": "InterceptDeploymentGroupDeployment" @@ -6480,6 +6494,11 @@ "readOnly": true, "type": "array" }, + "connectedDeploymentGroup": { + "$ref": "InterceptEndpointGroupConnectedDeploymentGroup", + "description": "Output only. Details about the connected deployment group to this endpoint group.", + "readOnly": true + }, "createTime": { "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", @@ -6491,7 +6510,7 @@ "type": "string" }, "interceptDeploymentGroup": { - "description": "Immutable. The deployment group that this endpoint group is connected to, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/124.", + "description": "Required. Immutable. The deployment group that this endpoint group is connected to, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/124.", "type": "string" }, "labels": { @@ -6553,7 +6572,7 @@ "type": "string" }, "interceptEndpointGroup": { - "description": "Immutable. The endpoint group that this association is connected to, for example: `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See https://google.aip.dev/124.", + "description": "Required. Immutable. The endpoint group that this association is connected to, for example: `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See https://google.aip.dev/124.", "type": "string" }, "labels": { @@ -6563,7 +6582,16 @@ "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, + "locations": { + "description": "Output only. The list of locations where the association is configured. This information is retrieved from the linked endpoint group.", + "items": { + "$ref": "InterceptLocation" + }, + "readOnly": true, + "type": "array" + }, "locationsDetails": { + "deprecated": true, "description": "Output only. The list of locations where the association is present. This information is retrieved from the linked endpoint group, and not configured as part of the association itself.", "items": { "$ref": "InterceptEndpointGroupAssociationLocationDetails" @@ -6576,7 +6604,7 @@ "type": "string" }, "network": { - "description": "Immutable. The VPC network that is associated. for example: `projects/123456789/global/networks/my-network`. See https://google.aip.dev/124.", + "description": "Required. Immutable. The VPC network that is associated. for example: `projects/123456789/global/networks/my-network`. See https://google.aip.dev/124.", "type": "string" }, "reconciling": { @@ -6683,6 +6711,53 @@ }, "type": "object" }, + "InterceptEndpointGroupConnectedDeploymentGroup": { + "description": "The endpoint group's view of a connected deployment group.", + "id": "InterceptEndpointGroupConnectedDeploymentGroup", + "properties": { + "locations": { + "description": "Output only. The list of locations where the deployment group is present.", + "items": { + "$ref": "InterceptLocation" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The connected deployment group's resource name, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/124.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterceptLocation": { + "description": "Details about intercept in a specific cloud location.", + "id": "InterceptLocation", + "properties": { + "location": { + "description": "Output only. The cloud location, e.g. \"us-central1-a\" or \"asia-south1\".", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of the association in this location.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "OUT_OF_SYNC" + ], + "enumDescriptions": [ + "State not set (this is not a valid state).", + "The resource is ready and in sync in the location.", + "The resource is out of sync in the location. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ListAddressGroupReferencesResponse": { "description": "Response of the ListAddressGroupReferences method.", "id": "ListAddressGroupReferencesResponse", @@ -7176,6 +7251,13 @@ "$ref": "ServerTlsPolicy" }, "type": "array" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request opts into `return_partial_success` and reading across collections e.g. when attempting to list all resources across all supported locations.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -7393,11 +7475,20 @@ "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, + "locations": { + "description": "Output only. The list of locations where the deployment group is present.", + "items": { + "$ref": "MirroringLocation" + }, + "readOnly": true, + "type": "array" + }, "name": { "description": "Immutable. Identifier. The resource name of this deployment group, for example: `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See https://google.aip.dev/122 for more details.", "type": "string" }, "nestedDeployments": { + "deprecated": true, "description": "Output only. The list of Mirroring Deployments that belong to this group.", "items": { "$ref": "MirroringDeploymentGroupDeployment" @@ -7497,6 +7588,14 @@ "readOnly": true, "type": "array" }, + "connectedDeploymentGroups": { + "description": "Output only. List of details about the connected deployment groups to this endpoint group.", + "items": { + "$ref": "MirroringEndpointGroupConnectedDeploymentGroup" + }, + "readOnly": true, + "type": "array" + }, "createTime": { "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", @@ -7576,7 +7675,16 @@ "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, + "locations": { + "description": "Output only. The list of locations where the association is configured. This information is retrieved from the linked endpoint group.", + "items": { + "$ref": "MirroringLocation" + }, + "readOnly": true, + "type": "array" + }, "locationsDetails": { + "deprecated": true, "description": "Output only. The list of locations where the association is present. This information is retrieved from the linked endpoint group, and not configured as part of the association itself.", "items": { "$ref": "MirroringEndpointGroupAssociationLocationDetails" @@ -7700,6 +7808,53 @@ }, "type": "object" }, + "MirroringEndpointGroupConnectedDeploymentGroup": { + "description": "The endpoint group's view of a connected deployment group.", + "id": "MirroringEndpointGroupConnectedDeploymentGroup", + "properties": { + "locations": { + "description": "Output only. The list of locations where the deployment group is present.", + "items": { + "$ref": "MirroringLocation" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The connected deployment group's resource name, for example: `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See https://google.aip.dev/124.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "MirroringLocation": { + "description": "Details about mirroring in a specific cloud location.", + "id": "MirroringLocation", + "properties": { + "location": { + "description": "Output only. The cloud location, e.g. \"us-central1-a\" or \"asia-south1\".", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of the association in this location.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "OUT_OF_SYNC" + ], + "enumDescriptions": [ + "State not set (this is not a valid state).", + "The resource is ready and in sync in the location.", + "The resource is out of sync in the location. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", diff --git a/networksecurity/v1beta1/networksecurity-gen.go b/networksecurity/v1beta1/networksecurity-gen.go index 182132ad1c..b69c695992 100644 --- a/networksecurity/v1beta1/networksecurity-gen.go +++ b/networksecurity/v1beta1/networksecurity-gen.go @@ -2209,7 +2209,7 @@ type InterceptDeployment struct { // additional context for the deployment. Description string `json:"description,omitempty"` // ForwardingRule: Required. Immutable. The regional forwarding rule that - // fronts the intercept collectors, for example: + // fronts the interceptors, for example: // `projects/123456789/regions/us-central1/forwardingRules/my-rule`. See // https://google.aip.dev/124. ForwardingRule string `json:"forwardingRule,omitempty"` @@ -2287,6 +2287,9 @@ type InterceptDeploymentGroup struct { // Labels: Optional. Labels are key/value pairs that help to organize and // filter resources. Labels map[string]string `json:"labels,omitempty"` + // Locations: Output only. The list of locations where the deployment group is + // present. + Locations []*InterceptLocation `json:"locations,omitempty"` // Name: Immutable. Identifier. The resource name of this deployment group, for // example: // `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See @@ -2411,14 +2414,17 @@ func (s InterceptDeploymentGroupDeployment) MarshalJSON() ([]byte, error) { type InterceptEndpointGroup struct { // Associations: Output only. List of associations to this endpoint group. Associations []*InterceptEndpointGroupAssociationDetails `json:"associations,omitempty"` + // ConnectedDeploymentGroup: Output only. Details about the connected + // deployment group to this endpoint group. + ConnectedDeploymentGroup *InterceptEndpointGroupConnectedDeploymentGroup `json:"connectedDeploymentGroup,omitempty"` // CreateTime: Output only. The timestamp when the resource was created. See // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` // Description: Optional. User-provided description of the endpoint group. Used // as additional context for the endpoint group. Description string `json:"description,omitempty"` - // InterceptDeploymentGroup: Immutable. The deployment group that this endpoint - // group is connected to, for example: + // InterceptDeploymentGroup: Required. Immutable. The deployment group that + // this endpoint group is connected to, for example: // `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See // https://google.aip.dev/124. InterceptDeploymentGroup string `json:"interceptDeploymentGroup,omitempty"` @@ -2490,14 +2496,17 @@ type InterceptEndpointGroupAssociation struct { // CreateTime: Output only. The timestamp when the resource was created. See // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` - // InterceptEndpointGroup: Immutable. The endpoint group that this association - // is connected to, for example: + // InterceptEndpointGroup: Required. Immutable. The endpoint group that this + // association is connected to, for example: // `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See // https://google.aip.dev/124. InterceptEndpointGroup string `json:"interceptEndpointGroup,omitempty"` // Labels: Optional. Labels are key/value pairs that help to organize and // filter resources. Labels map[string]string `json:"labels,omitempty"` + // Locations: Output only. The list of locations where the association is + // configured. This information is retrieved from the linked endpoint group. + Locations []*InterceptLocation `json:"locations,omitempty"` // LocationsDetails: Output only. The list of locations where the association // is present. This information is retrieved from the linked endpoint group, // and not configured as part of the association itself. @@ -2507,8 +2516,8 @@ type InterceptEndpointGroupAssociation struct { // `projects/123456789/locations/global/interceptEndpointGroupAssociations/my-eg // -association`. See https://google.aip.dev/122 for more details. Name string `json:"name,omitempty"` - // Network: Immutable. The VPC network that is associated. for example: - // `projects/123456789/global/networks/my-network`. See + // Network: Required. Immutable. The VPC network that is associated. for + // example: `projects/123456789/global/networks/my-network`. See // https://google.aip.dev/124. Network string `json:"network,omitempty"` // Reconciling: Output only. The current state of the resource does not match @@ -2642,6 +2651,67 @@ func (s InterceptEndpointGroupAssociationLocationDetails) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InterceptEndpointGroupConnectedDeploymentGroup: The endpoint group's view of +// a connected deployment group. +type InterceptEndpointGroupConnectedDeploymentGroup struct { + // Locations: Output only. The list of locations where the deployment group is + // present. + Locations []*InterceptLocation `json:"locations,omitempty"` + // Name: Output only. The connected deployment group's resource name, for + // example: + // `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See + // https://google.aip.dev/124. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 InterceptEndpointGroupConnectedDeploymentGroup) MarshalJSON() ([]byte, error) { + type NoMethod InterceptEndpointGroupConnectedDeploymentGroup + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InterceptLocation: Details about intercept in a specific cloud location. +type InterceptLocation struct { + // Location: Output only. The cloud location, e.g. "us-central1-a" or + // "asia-south1". + Location string `json:"location,omitempty"` + // State: Output only. The current state of the association in this location. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The resource is ready and in sync in the location. + // "OUT_OF_SYNC" - The resource is out of sync in the location. In most + // cases, this is a result of a transient issue within the system (e.g. an + // inaccessible location) and the system is expected to recover automatically. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") 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. "Location") 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 InterceptLocation) MarshalJSON() ([]byte, error) { + type NoMethod InterceptLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListAddressGroupReferencesResponse: Response of the // ListAddressGroupReferences method. type ListAddressGroupReferencesResponse struct { @@ -3366,6 +3436,10 @@ type ListServerTlsPoliciesResponse struct { NextPageToken string `json:"nextPageToken,omitempty"` // ServerTlsPolicies: List of ServerTlsPolicy resources. ServerTlsPolicies []*ServerTlsPolicy `json:"serverTlsPolicies,omitempty"` + // Unreachable: Unreachable resources. Populated when the request opts into + // `return_partial_success` and reading across collections e.g. when attempting + // to list all resources across all supported locations. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -3631,6 +3705,9 @@ type MirroringDeploymentGroup struct { // Labels: Optional. Labels are key/value pairs that help to organize and // filter resources. Labels map[string]string `json:"labels,omitempty"` + // Locations: Output only. The list of locations where the deployment group is + // present. + Locations []*MirroringLocation `json:"locations,omitempty"` // Name: Immutable. Identifier. The resource name of this deployment group, for // example: // `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See @@ -3755,6 +3832,9 @@ func (s MirroringDeploymentGroupDeployment) MarshalJSON() ([]byte, error) { type MirroringEndpointGroup struct { // Associations: Output only. List of associations to this endpoint group. Associations []*MirroringEndpointGroupAssociationDetails `json:"associations,omitempty"` + // ConnectedDeploymentGroups: Output only. List of details about the connected + // deployment groups to this endpoint group. + ConnectedDeploymentGroups []*MirroringEndpointGroupConnectedDeploymentGroup `json:"connectedDeploymentGroups,omitempty"` // CreateTime: Output only. The timestamp when the resource was created. See // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` @@ -3837,6 +3917,9 @@ type MirroringEndpointGroupAssociation struct { // Labels: Optional. Labels are key/value pairs that help to organize and // filter resources. Labels map[string]string `json:"labels,omitempty"` + // Locations: Output only. The list of locations where the association is + // configured. This information is retrieved from the linked endpoint group. + Locations []*MirroringLocation `json:"locations,omitempty"` // LocationsDetails: Output only. The list of locations where the association // is present. This information is retrieved from the linked endpoint group, // and not configured as part of the association itself. @@ -3986,6 +4069,67 @@ func (s MirroringEndpointGroupAssociationLocationDetails) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// MirroringEndpointGroupConnectedDeploymentGroup: The endpoint group's view of +// a connected deployment group. +type MirroringEndpointGroupConnectedDeploymentGroup struct { + // Locations: Output only. The list of locations where the deployment group is + // present. + Locations []*MirroringLocation `json:"locations,omitempty"` + // Name: Output only. The connected deployment group's resource name, for + // example: + // `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See + // https://google.aip.dev/124. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 MirroringEndpointGroupConnectedDeploymentGroup) MarshalJSON() ([]byte, error) { + type NoMethod MirroringEndpointGroupConnectedDeploymentGroup + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// MirroringLocation: Details about mirroring in a specific cloud location. +type MirroringLocation struct { + // Location: Output only. The cloud location, e.g. "us-central1-a" or + // "asia-south1". + Location string `json:"location,omitempty"` + // State: Output only. The current state of the association in this location. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The resource is ready and in sync in the location. + // "OUT_OF_SYNC" - The resource is out of sync in the location. In most + // cases, this is a result of a transient issue within the system (e.g. an + // inaccessible location) and the system is expected to recover automatically. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") 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. "Location") 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 MirroringLocation) MarshalJSON() ([]byte, error) { + type NoMethod MirroringLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is the // result of a network API call. type Operation struct { @@ -21071,6 +21215,17 @@ func (c *ProjectsLocationsServerTlsPoliciesListCall) PageToken(pageToken string) return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Setting this field to `true` will opt the request into returning the +// resources that are reachable, and into including the names of those that +// were unreachable in the [ListServerTlsPoliciesResponse.unreachable] field. +// This can only be `true` when reading across collections e.g. when `parent` +// is set to "projects/example/locations/-". +func (c *ProjectsLocationsServerTlsPoliciesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsServerTlsPoliciesListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + 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/networkservices/v1/networkservices-api.json b/networkservices/v1/networkservices-api.json index 0fa5faa238..2862212e93 100644 --- a/networkservices/v1/networkservices-api.json +++ b/networkservices/v1/networkservices-api.json @@ -2939,7 +2939,7 @@ } } }, - "revision": "20250224", + "revision": "20250310", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -3319,7 +3319,7 @@ "type": "string" }, "supportedEvents": { - "description": "Optional. A set of events during request or response processing for which this extension is called. This field is required for the `LbTrafficExtension` resource. It must not be set for the `LbRouteExtension` resource, otherwise a validation error is returned.", + "description": "Optional. A set of events during request or response processing for which this extension is called. This field is required for the `LbTrafficExtension` resource. It is optional for the `LbRouteExtension` resource. If unspecified `REQUEST_HEADERS` event is assumed as supported.", "items": { "enum": [ "EVENT_TYPE_UNSPECIFIED", @@ -4584,6 +4584,13 @@ "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -4731,6 +4738,13 @@ "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -4792,6 +4806,13 @@ "$ref": "ServiceBinding" }, "type": "array" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -4810,6 +4831,13 @@ "$ref": "ServiceLbPolicy" }, "type": "array" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/networkservices/v1/networkservices-gen.go b/networkservices/v1/networkservices-gen.go index 275a66d8c3..30e5bed8be 100644 --- a/networkservices/v1/networkservices-gen.go +++ b/networkservices/v1/networkservices-gen.go @@ -1017,8 +1017,8 @@ type ExtensionChainExtension struct { Service string `json:"service,omitempty"` // SupportedEvents: Optional. A set of events during request or response // processing for which this extension is called. This field is required for - // the `LbTrafficExtension` resource. It must not be set for the - // `LbRouteExtension` resource, otherwise a validation error is returned. + // the `LbTrafficExtension` resource. It is optional for the `LbRouteExtension` + // resource. If unspecified `REQUEST_HEADERS` event is assumed as supported. // // Possible values: // "EVENT_TYPE_UNSPECIFIED" - Unspecified value. Do not use. @@ -2649,6 +2649,10 @@ type ListGatewayRouteViewsResponse struct { // NextPageToken: A token, which can be sent as `page_token` to retrieve the // next page. If this field is omitted, there are no subsequent pages. NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2860,6 +2864,10 @@ type ListMeshRouteViewsResponse struct { // NextPageToken: A token, which can be sent as `page_token` to retrieve the // next page. If this field is omitted, there are no subsequent pages. NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2953,6 +2961,10 @@ type ListServiceBindingsResponse struct { NextPageToken string `json:"nextPageToken,omitempty"` // ServiceBindings: List of ServiceBinding resources. ServiceBindings []*ServiceBinding `json:"serviceBindings,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2984,6 +2996,10 @@ type ListServiceLbPoliciesResponse struct { NextPageToken string `json:"nextPageToken,omitempty"` // ServiceLbPolicies: List of ServiceLbPolicy resources. ServiceLbPolicies []*ServiceLbPolicy `json:"serviceLbPolicies,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` diff --git a/networkservices/v1beta1/networkservices-api.json b/networkservices/v1beta1/networkservices-api.json index 320dd52126..a8cb10fe7f 100644 --- a/networkservices/v1beta1/networkservices-api.json +++ b/networkservices/v1beta1/networkservices-api.json @@ -2666,7 +2666,7 @@ } } }, - "revision": "20250224", + "revision": "20250310", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuthzExtension": { @@ -2910,7 +2910,7 @@ "type": "string" }, "supportedEvents": { - "description": "Optional. A set of events during request or response processing for which this extension is called. This field is required for the `LbTrafficExtension` resource. It must not be set for the `LbRouteExtension` resource, otherwise a validation error is returned.", + "description": "Optional. A set of events during request or response processing for which this extension is called. This field is required for the `LbTrafficExtension` resource. It is optional for the `LbRouteExtension` resource. If unspecified `REQUEST_HEADERS` event is assumed as supported.", "items": { "enum": [ "EVENT_TYPE_UNSPECIFIED", @@ -4175,6 +4175,13 @@ "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -4322,6 +4329,13 @@ "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -4383,6 +4397,13 @@ "$ref": "ServiceBinding" }, "type": "array" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -4401,6 +4422,13 @@ "$ref": "ServiceLbPolicy" }, "type": "array" + }, + "unreachable": { + "description": "Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" diff --git a/networkservices/v1beta1/networkservices-gen.go b/networkservices/v1beta1/networkservices-gen.go index 4dc1592995..c47067e85c 100644 --- a/networkservices/v1beta1/networkservices-gen.go +++ b/networkservices/v1beta1/networkservices-gen.go @@ -685,8 +685,8 @@ type ExtensionChainExtension struct { Service string `json:"service,omitempty"` // SupportedEvents: Optional. A set of events during request or response // processing for which this extension is called. This field is required for - // the `LbTrafficExtension` resource. It must not be set for the - // `LbRouteExtension` resource, otherwise a validation error is returned. + // the `LbTrafficExtension` resource. It is optional for the `LbRouteExtension` + // resource. If unspecified `REQUEST_HEADERS` event is assumed as supported. // // Possible values: // "EVENT_TYPE_UNSPECIFIED" - Unspecified value. Do not use. @@ -2317,6 +2317,10 @@ type ListGatewayRouteViewsResponse struct { // NextPageToken: A token, which can be sent as `page_token` to retrieve the // next page. If this field is omitted, there are no subsequent pages. NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2528,6 +2532,10 @@ type ListMeshRouteViewsResponse struct { // NextPageToken: A token, which can be sent as `page_token` to retrieve the // next page. If this field is omitted, there are no subsequent pages. NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2621,6 +2629,10 @@ type ListServiceBindingsResponse struct { NextPageToken string `json:"nextPageToken,omitempty"` // ServiceBindings: List of ServiceBinding resources. ServiceBindings []*ServiceBinding `json:"serviceBindings,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2652,6 +2664,10 @@ type ListServiceLbPoliciesResponse struct { NextPageToken string `json:"nextPageToken,omitempty"` // ServiceLbPolicies: List of ServiceLbPolicy resources. ServiceLbPolicies []*ServiceLbPolicy `json:"serviceLbPolicies,omitempty"` + // Unreachable: Unreachable resources. Populated when the request attempts to + // list all resources across all supported locations, while some locations are + // temporarily unavailable. + Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` diff --git a/notebooks/v2/notebooks-api.json b/notebooks/v2/notebooks-api.json index 7f8d0222e8..82af6a86b1 100644 --- a/notebooks/v2/notebooks-api.json +++ b/notebooks/v2/notebooks-api.json @@ -904,7 +904,7 @@ } } }, - "revision": "20250101", + "revision": "20250224", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1080,6 +1080,11 @@ "description": "Output only. The default values for configuration.", "readOnly": true }, + "disableWorkbenchLegacyCreation": { + "description": "Output only. Flag to disable the creation of legacy Workbench notebooks (User-managed notebooks and Google-managed notebooks).", + "readOnly": true, + "type": "boolean" + }, "supportedValues": { "$ref": "SupportedValues", "description": "Output only. The supported values for configuration.", diff --git a/notebooks/v2/notebooks-gen.go b/notebooks/v2/notebooks-gen.go index 87eaa50216..c3f9c716cc 100644 --- a/notebooks/v2/notebooks-gen.go +++ b/notebooks/v2/notebooks-gen.go @@ -467,6 +467,10 @@ type Config struct { AvailableImages []*ImageRelease `json:"availableImages,omitempty"` // DefaultValues: Output only. The default values for configuration. DefaultValues *DefaultValues `json:"defaultValues,omitempty"` + // DisableWorkbenchLegacyCreation: Output only. Flag to disable the creation of + // legacy Workbench notebooks (User-managed notebooks and Google-managed + // notebooks). + DisableWorkbenchLegacyCreation bool `json:"disableWorkbenchLegacyCreation,omitempty"` // SupportedValues: Output only. The supported values for configuration. SupportedValues *SupportedValues `json:"supportedValues,omitempty"` diff --git a/oracledatabase/v1/oracledatabase-api.json b/oracledatabase/v1/oracledatabase-api.json index 04eac59d9b..fb72bdb491 100644 --- a/oracledatabase/v1/oracledatabase-api.json +++ b/oracledatabase/v1/oracledatabase-api.json @@ -436,6 +436,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "restart": { + "description": "Restarts an Autonomous Database.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:restart", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.autonomousDatabases.restart", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the Autonomous Database in the following format: projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/autonomousDatabases/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:restart", + "request": { + "$ref": "RestartAutonomousDatabaseRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "restore": { "description": "Restores a single Autonomous Database.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:restore", @@ -463,6 +491,62 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "start": { + "description": "Starts an Autonomous Database.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:start", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.autonomousDatabases.start", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the Autonomous Database in the following format: projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/autonomousDatabases/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:start", + "request": { + "$ref": "StartAutonomousDatabaseRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "stop": { + "description": "Stops an Autonomous Database.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:stop", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.autonomousDatabases.stop", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the Autonomous Database in the following format: projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/autonomousDatabases/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:stop", + "request": { + "$ref": "StopAutonomousDatabaseRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -1119,7 +1203,7 @@ } } }, - "revision": "20250223", + "revision": "20250312", "rootUrl": "https://oracledatabase.googleapis.com/", "schemas": { "AllConnectionStrings": { @@ -3639,6 +3723,12 @@ }, "type": "object" }, + "RestartAutonomousDatabaseRequest": { + "description": "The request for `AutonomousDatabase.Restart`.", + "id": "RestartAutonomousDatabaseRequest", + "properties": {}, + "type": "object" + }, "RestoreAutonomousDatabaseRequest": { "description": "The request for `AutonomousDatabase.Restore`.", "id": "RestoreAutonomousDatabaseRequest", @@ -3693,6 +3783,12 @@ }, "type": "object" }, + "StartAutonomousDatabaseRequest": { + "description": "The request for `AutonomousDatabase.Start`.", + "id": "StartAutonomousDatabaseRequest", + "properties": {}, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -3720,6 +3816,12 @@ }, "type": "object" }, + "StopAutonomousDatabaseRequest": { + "description": "The request for `AutonomousDatabase.Stop`.", + "id": "StopAutonomousDatabaseRequest", + "properties": {}, + "type": "object" + }, "TimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "TimeOfDay", diff --git a/oracledatabase/v1/oracledatabase-gen.go b/oracledatabase/v1/oracledatabase-gen.go index 6713d3fef6..255ffd624f 100644 --- a/oracledatabase/v1/oracledatabase-gen.go +++ b/oracledatabase/v1/oracledatabase-gen.go @@ -2624,6 +2624,11 @@ func (s *OperationMetadata) UnmarshalJSON(data []byte) error { return nil } +// RestartAutonomousDatabaseRequest: The request for +// `AutonomousDatabase.Restart`. +type RestartAutonomousDatabaseRequest struct { +} + // RestoreAutonomousDatabaseRequest: The request for // `AutonomousDatabase.Restore`. type RestoreAutonomousDatabaseRequest struct { @@ -2684,6 +2689,10 @@ func (s ScheduledOperationDetails) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StartAutonomousDatabaseRequest: The request for `AutonomousDatabase.Start`. +type StartAutonomousDatabaseRequest struct { +} + // Status: The `Status` type defines a logical error model that is suitable for // different programming environments, including REST APIs and RPC APIs. It is // used by gRPC (https://github.com/grpc). Each `Status` message contains three @@ -2718,6 +2727,10 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StopAutonomousDatabaseRequest: The request for `AutonomousDatabase.Stop`. +type StopAutonomousDatabaseRequest struct { +} + // TimeOfDay: Represents a time of day. The date and time zone are either not // significant or are specified elsewhere. An API may choose to allow leap // seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. @@ -3978,6 +3991,111 @@ func (c *ProjectsLocationsAutonomousDatabasesListCall) Pages(ctx context.Context } } +type ProjectsLocationsAutonomousDatabasesRestartCall struct { + s *Service + name string + restartautonomousdatabaserequest *RestartAutonomousDatabaseRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Restart: Restarts an Autonomous Database. +// +// - name: The name of the Autonomous Database in the following format: +// projects/{project}/locations/{location}/autonomousDatabases/{autonomous_dat +// abase}. +func (r *ProjectsLocationsAutonomousDatabasesService) Restart(name string, restartautonomousdatabaserequest *RestartAutonomousDatabaseRequest) *ProjectsLocationsAutonomousDatabasesRestartCall { + c := &ProjectsLocationsAutonomousDatabasesRestartCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.restartautonomousdatabaserequest = restartautonomousdatabaserequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsAutonomousDatabasesRestartCall) Fields(s ...googleapi.Field) *ProjectsLocationsAutonomousDatabasesRestartCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAutonomousDatabasesRestartCall) Context(ctx context.Context) *ProjectsLocationsAutonomousDatabasesRestartCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsAutonomousDatabasesRestartCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAutonomousDatabasesRestartCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.restartautonomousdatabaserequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:restart") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.autonomousDatabases.restart", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.autonomousDatabases.restart" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsAutonomousDatabasesRestartCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.autonomousDatabases.restart", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsAutonomousDatabasesRestoreCall struct { s *Service name string @@ -4083,6 +4201,216 @@ func (c *ProjectsLocationsAutonomousDatabasesRestoreCall) Do(opts ...googleapi.C return ret, nil } +type ProjectsLocationsAutonomousDatabasesStartCall struct { + s *Service + name string + startautonomousdatabaserequest *StartAutonomousDatabaseRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Start: Starts an Autonomous Database. +// +// - name: The name of the Autonomous Database in the following format: +// projects/{project}/locations/{location}/autonomousDatabases/{autonomous_dat +// abase}. +func (r *ProjectsLocationsAutonomousDatabasesService) Start(name string, startautonomousdatabaserequest *StartAutonomousDatabaseRequest) *ProjectsLocationsAutonomousDatabasesStartCall { + c := &ProjectsLocationsAutonomousDatabasesStartCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.startautonomousdatabaserequest = startautonomousdatabaserequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsAutonomousDatabasesStartCall) Fields(s ...googleapi.Field) *ProjectsLocationsAutonomousDatabasesStartCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAutonomousDatabasesStartCall) Context(ctx context.Context) *ProjectsLocationsAutonomousDatabasesStartCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsAutonomousDatabasesStartCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAutonomousDatabasesStartCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.startautonomousdatabaserequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:start") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.autonomousDatabases.start", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.autonomousDatabases.start" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsAutonomousDatabasesStartCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.autonomousDatabases.start", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsAutonomousDatabasesStopCall struct { + s *Service + name string + stopautonomousdatabaserequest *StopAutonomousDatabaseRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Stop: Stops an Autonomous Database. +// +// - name: The name of the Autonomous Database in the following format: +// projects/{project}/locations/{location}/autonomousDatabases/{autonomous_dat +// abase}. +func (r *ProjectsLocationsAutonomousDatabasesService) Stop(name string, stopautonomousdatabaserequest *StopAutonomousDatabaseRequest) *ProjectsLocationsAutonomousDatabasesStopCall { + c := &ProjectsLocationsAutonomousDatabasesStopCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.stopautonomousdatabaserequest = stopautonomousdatabaserequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsAutonomousDatabasesStopCall) Fields(s ...googleapi.Field) *ProjectsLocationsAutonomousDatabasesStopCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAutonomousDatabasesStopCall) Context(ctx context.Context) *ProjectsLocationsAutonomousDatabasesStopCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsAutonomousDatabasesStopCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAutonomousDatabasesStopCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.stopautonomousdatabaserequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:stop") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.autonomousDatabases.stop", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.autonomousDatabases.stop" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsAutonomousDatabasesStopCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.autonomousDatabases.stop", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsAutonomousDbVersionsListCall struct { s *Service parent string diff --git a/oslogin/v1/oslogin-api.json b/oslogin/v1/oslogin-api.json index 2ddce5c1e3..05f843096b 100644 --- a/oslogin/v1/oslogin-api.json +++ b/oslogin/v1/oslogin-api.json @@ -349,7 +349,7 @@ } } }, - "revision": "20231217", + "revision": "20250317", "rootUrl": "https://oslogin.googleapis.com/", "schemas": { "Empty": { @@ -478,7 +478,7 @@ "type": "string" }, "key": { - "description": "Public key text in SSH format, defined by RFC4253 section 6.6.", + "description": "Required. Public key text in SSH format, defined by [RFC4253](https://www.ietf.org/rfc/rfc4253.txt) section 6.6.", "type": "string" }, "name": { diff --git a/oslogin/v1/oslogin-gen.go b/oslogin/v1/oslogin-gen.go index aeca668974..07d5b19568 100644 --- a/oslogin/v1/oslogin-gen.go +++ b/oslogin/v1/oslogin-gen.go @@ -335,7 +335,8 @@ type SshPublicKey struct { ExpirationTimeUsec int64 `json:"expirationTimeUsec,omitempty,string"` // Fingerprint: Output only. The SHA-256 fingerprint of the SSH public key. Fingerprint string `json:"fingerprint,omitempty"` - // Key: Public key text in SSH format, defined by RFC4253 section 6.6. + // Key: Required. Public key text in SSH format, defined by RFC4253 + // (https://www.ietf.org/rfc/rfc4253.txt) section 6.6. Key string `json:"key,omitempty"` // Name: Output only. The canonical resource name. Name string `json:"name,omitempty"` diff --git a/oslogin/v1alpha/oslogin-api.json b/oslogin/v1alpha/oslogin-api.json index 2e6a67b8cd..0c0aa35fbd 100644 --- a/oslogin/v1alpha/oslogin-api.json +++ b/oslogin/v1alpha/oslogin-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20250302", + "revision": "20250317", "rootUrl": "https://oslogin.googleapis.com/", "schemas": { "Empty": { @@ -773,7 +773,7 @@ "type": "string" }, "key": { - "description": "Public key text in SSH format, defined by RFC4253 section 6.6.", + "description": "Required. Public key text in SSH format, defined by [RFC4253](https://www.ietf.org/rfc/rfc4253.txt) section 6.6.", "type": "string" }, "name": { diff --git a/oslogin/v1alpha/oslogin-gen.go b/oslogin/v1alpha/oslogin-gen.go index f94a16ac6d..9153369264 100644 --- a/oslogin/v1alpha/oslogin-gen.go +++ b/oslogin/v1alpha/oslogin-gen.go @@ -553,7 +553,8 @@ type SshPublicKey struct { ExpirationTimeUsec int64 `json:"expirationTimeUsec,omitempty,string"` // Fingerprint: Output only. The SHA-256 fingerprint of the SSH public key. Fingerprint string `json:"fingerprint,omitempty"` - // Key: Public key text in SSH format, defined by RFC4253 section 6.6. + // Key: Required. Public key text in SSH format, defined by RFC4253 + // (https://www.ietf.org/rfc/rfc4253.txt) section 6.6. Key string `json:"key,omitempty"` // Name: Output only. The canonical resource name. Name string `json:"name,omitempty"` diff --git a/oslogin/v1beta/oslogin-api.json b/oslogin/v1beta/oslogin-api.json index 731fd0f146..59d37284db 100644 --- a/oslogin/v1beta/oslogin-api.json +++ b/oslogin/v1beta/oslogin-api.json @@ -512,7 +512,7 @@ } } }, - "revision": "20250302", + "revision": "20250317", "rootUrl": "https://oslogin.googleapis.com/", "schemas": { "Empty": { @@ -743,7 +743,7 @@ "type": "string" }, "key": { - "description": "Public key text in SSH format, defined by RFC4253 section 6.6.", + "description": "Required. Public key text in SSH format, defined by [RFC4253](https://www.ietf.org/rfc/rfc4253.txt) section 6.6.", "type": "string" }, "name": { diff --git a/oslogin/v1beta/oslogin-gen.go b/oslogin/v1beta/oslogin-gen.go index 528a580ae8..47ce613058 100644 --- a/oslogin/v1beta/oslogin-gen.go +++ b/oslogin/v1beta/oslogin-gen.go @@ -553,7 +553,8 @@ type SshPublicKey struct { ExpirationTimeUsec int64 `json:"expirationTimeUsec,omitempty,string"` // Fingerprint: Output only. The SHA-256 fingerprint of the SSH public key. Fingerprint string `json:"fingerprint,omitempty"` - // Key: Public key text in SSH format, defined by RFC4253 section 6.6. + // Key: Required. Public key text in SSH format, defined by RFC4253 + // (https://www.ietf.org/rfc/rfc4253.txt) section 6.6. Key string `json:"key,omitempty"` // Name: Output only. The canonical resource name. Name string `json:"name,omitempty"` diff --git a/paymentsresellersubscription/v1/paymentsresellersubscription-api.json b/paymentsresellersubscription/v1/paymentsresellersubscription-api.json index 5d81dbb430..76ae39181d 100644 --- a/paymentsresellersubscription/v1/paymentsresellersubscription-api.json +++ b/paymentsresellersubscription/v1/paymentsresellersubscription-api.json @@ -110,7 +110,7 @@ "products": { "methods": { "list": { - "description": "To retrieve the products that can be resold by the partner. It should be autenticated with a service account. - This API doesn't apply to YouTube products currently.", + "description": "Currently, it doesn't support **YouTube** products. Retrieves the products that can be resold by the partner. It should be autenticated with a service account.", "flatPath": "v1/partners/{partnersId}/products", "httpMethod": "GET", "id": "paymentsresellersubscription.partners.products.list", @@ -155,7 +155,7 @@ "promotions": { "methods": { "findEligible": { - "description": "To find eligible promotions for the current user. The API requires user authorization via OAuth. The bare minimum oauth scope `openid` is sufficient, which will skip the consent screen.", + "description": "Currently, it is only enabeld for **YouTube**. Finds eligible promotions for the current user. The API requires user authorization via OAuth. The bare minimum oauth scope `openid` is sufficient, which will skip the consent screen.", "flatPath": "v1/partners/{partnersId}/promotions:findEligible", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.promotions.findEligible", @@ -183,7 +183,7 @@ ] }, "list": { - "description": "Retrieves the promotions, such as free trial, that can be used by the partner. - This API doesn't apply to YouTube promotions currently. It should be autenticated with a service account.", + "description": "Currently, it doesn't support **YouTube** promotions. Retrieves the promotions, such as free trial, that can be used by the partner. It should be autenticated with a service account.", "flatPath": "v1/partners/{partnersId}/promotions", "httpMethod": "GET", "id": "paymentsresellersubscription.partners.promotions.list", @@ -228,7 +228,7 @@ "subscriptions": { "methods": { "cancel": { - "description": "Used by partners to cancel a subscription service either immediately or by the end of the current billing cycle for their customers. It should be called directly by the partner using service accounts.", + "description": "Cancels a subscription service either immediately or by the end of the current billing cycle for their customers. It should be called directly by the partner using service accounts.", "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}:cancel", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.subscriptions.cancel", @@ -289,7 +289,7 @@ ] }, "entitle": { - "description": "Used by partners to entitle a previously provisioned subscription to the current end user. The end user identity is inferred from the authorized credential of the request. This API must be authorized by the end user using OAuth.", + "description": "Entitles a previously provisioned subscription to the current end user. The end user identity is inferred from the authorized credential of the request. This API must be authorized by the end user using OAuth.", "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}:entitle", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.subscriptions.entitle", @@ -317,7 +317,7 @@ ] }, "extend": { - "description": "[Opt-in only] Most partners should be on auto-extend by default. Used by partners to extend a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.", + "description": "[Opt-in only] Most partners should be on auto-extend by default. Extends a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.", "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}:extend", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.subscriptions.extend", @@ -345,7 +345,7 @@ ] }, "get": { - "description": "Used by partners to get a subscription by id. It should be called directly by the partner using service accounts.", + "description": "Gets a subscription by id. It should be called directly by the partner using service accounts.", "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}", "httpMethod": "GET", "id": "paymentsresellersubscription.partners.subscriptions.get", @@ -403,7 +403,7 @@ ] }, "undoCancel": { - "description": "Revokes the pending cancellation of a subscription, which is currently in `STATE_CANCEL_AT_END_OF_CYCLE` state. If the subscription is already cancelled, the request will fail. - **This API doesn't apply to YouTube subscriptions.** It should be called directly by the partner using service accounts.", + "description": "Currently, it is used by **Google One, Play Pass** partners. Revokes the pending cancellation of a subscription, which is currently in `STATE_CANCEL_AT_END_OF_CYCLE` state. If the subscription is already cancelled, the request will fail. It should be called directly by the partner using service accounts.", "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}:undoCancel", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.subscriptions.undoCancel", @@ -435,7 +435,7 @@ "userSessions": { "methods": { "generate": { - "description": "This API replaces user authorized OAuth consent based APIs (Create, Entitle). Generates a short-lived token for a user session based on the user intent. You can use the session token to redirect the user to Google to finish the signup flow. You can re-generate new session token repeatedly for the same request if necessary, regardless of the previous tokens being expired or not.", + "description": "This API replaces user authorized OAuth consent based APIs (Create, Entitle). Issues a timed session token for the given user intent. You can use the session token to redirect the user to Google to finish the signup flow. You can re-generate new session token repeatedly for the same request if necessary, regardless of the previous tokens being expired or not.", "flatPath": "v1/partners/{partnersId}/userSessions:generate", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.userSessions.generate", @@ -467,7 +467,7 @@ } } }, - "revision": "20250302", + "revision": "20250312", "rootUrl": "https://paymentsresellersubscription.googleapis.com/", "schemas": { "GoogleCloudPaymentsResellerSubscriptionV1Amount": { @@ -770,7 +770,7 @@ "id": "GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload", "properties": { "attachedToGoogleStructure": { - "description": "Output only. Output only. This identifies whether the subscription is attached to a Google Home structure.", + "description": "Output only. This identifies whether the subscription is attached to a Google Home structure.", "readOnly": true, "type": "boolean" }, @@ -907,7 +907,7 @@ "properties": { "bundleDetails": { "$ref": "ProductBundleDetails", - "description": "Output only. Output Only. Specifies the details for a bundle product.", + "description": "Output only. Specifies the details for a bundle product.", "readOnly": true }, "finiteBillingCycleDetails": { @@ -927,7 +927,7 @@ "type": "array" }, "productType": { - "description": "Output only. Output Only. Specifies the type of the product.", + "description": "Output only. Specifies the type of the product.", "enum": [ "PRODUCT_TYPE_UNSPECIFIED", "PRODUCT_TYPE_SUBSCRIPTION", @@ -1043,7 +1043,7 @@ "type": "string" }, "promotionType": { - "description": "Output only. Output Only. Specifies the type of the promotion.", + "description": "Output only. Specifies the type of the promotion.", "enum": [ "PROMOTION_TYPE_UNSPECIFIED", "PROMOTION_TYPE_FREE_TRIAL", @@ -1112,7 +1112,7 @@ "type": "string" }, "recurrenceCount": { - "description": "Output only. Output Only. The duration of an introductory offer in billing cycles.", + "description": "Output only. The duration of an introductory offer in billing cycles.", "format": "int32", "readOnly": true, "type": "integer" diff --git a/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go b/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go index 91e000ed04..e868404568 100644 --- a/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go +++ b/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go @@ -731,8 +731,8 @@ func (s GoogleCloudPaymentsResellerSubscriptionV1GenerateUserSessionResponse) Ma // GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload: Payload specific // for Google Home products. type GoogleCloudPaymentsResellerSubscriptionV1GoogleHomePayload struct { - // AttachedToGoogleStructure: Output only. Output only. This identifies whether - // the subscription is attached to a Google Home structure. + // AttachedToGoogleStructure: Output only. This identifies whether the + // subscription is attached to a Google Home structure. AttachedToGoogleStructure bool `json:"attachedToGoogleStructure,omitempty"` // PartnerStructureId: Optional. This identifies the structure ID on partner // side that the subscription should be applied to. Only required when the @@ -921,8 +921,7 @@ func (s GoogleCloudPaymentsResellerSubscriptionV1Location) MarshalJSON() ([]byte // GoogleCloudPaymentsResellerSubscriptionV1Product: A Product resource that // defines a subscription service that can be resold. type GoogleCloudPaymentsResellerSubscriptionV1Product struct { - // BundleDetails: Output only. Output Only. Specifies the details for a bundle - // product. + // BundleDetails: Output only. Specifies the details for a bundle product. BundleDetails *ProductBundleDetails `json:"bundleDetails,omitempty"` // FiniteBillingCycleDetails: Optional. Details for a subscription line item // with finite billing cycles. If unset, the line item will be charged @@ -934,7 +933,7 @@ type GoogleCloudPaymentsResellerSubscriptionV1Product struct { // PriceConfigs: Output only. Price configs for the product in the available // regions. PriceConfigs []*GoogleCloudPaymentsResellerSubscriptionV1ProductPriceConfig `json:"priceConfigs,omitempty"` - // ProductType: Output only. Output Only. Specifies the type of the product. + // ProductType: Output only. Specifies the type of the product. // // Possible values: // "PRODUCT_TYPE_UNSPECIFIED" - Unspecified. It's reserved as an unexpected @@ -1068,8 +1067,7 @@ type GoogleCloudPaymentsResellerSubscriptionV1Promotion struct { // promotion. It will have the format of // "partners/{partner_id}/promotion/{promotion_id}" Name string `json:"name,omitempty"` - // PromotionType: Output only. Output Only. Specifies the type of the - // promotion. + // PromotionType: Output only. Specifies the type of the promotion. // // Possible values: // "PROMOTION_TYPE_UNSPECIFIED" - The promotion type is unspecified. @@ -1137,8 +1135,8 @@ type GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetail // DiscountRatioMicros: Output only. The discount percentage in micros. For // example, 50,000 represents 5%. DiscountRatioMicros int64 `json:"discountRatioMicros,omitempty,string"` - // RecurrenceCount: Output only. Output Only. The duration of an introductory - // offer in billing cycles. + // RecurrenceCount: Output only. The duration of an introductory offer in + // billing cycles. RecurrenceCount int64 `json:"recurrenceCount,omitempty"` // RegionCode: Output only. 2-letter ISO region code where the product is // available in. Ex. "US". @@ -1802,9 +1800,9 @@ type PartnersProductsListCall struct { header_ http.Header } -// List: To retrieve the products that can be resold by the partner. It should -// be autenticated with a service account. - This API doesn't apply to YouTube -// products currently. +// List: Currently, it doesn't support **YouTube** products. Retrieves the +// products that can be resold by the partner. It should be autenticated with a +// service account. // // - parent: The parent, the partner that can resell. Format: // partners/{partner}. @@ -1969,9 +1967,10 @@ type PartnersPromotionsFindEligibleCall struct { header_ http.Header } -// FindEligible: To find eligible promotions for the current user. The API -// requires user authorization via OAuth. The bare minimum oauth scope `openid` -// is sufficient, which will skip the consent screen. +// FindEligible: Currently, it is only enabeld for **YouTube**. Finds eligible +// promotions for the current user. The API requires user authorization via +// OAuth. The bare minimum oauth scope `openid` is sufficient, which will skip +// the consent screen. // // - parent: The parent, the partner that can resell. Format: // partners/{partner}. @@ -2099,8 +2098,8 @@ type PartnersPromotionsListCall struct { header_ http.Header } -// List: Retrieves the promotions, such as free trial, that can be used by the -// partner. - This API doesn't apply to YouTube promotions currently. It should +// List: Currently, it doesn't support **YouTube** promotions. Retrieves the +// promotions, such as free trial, that can be used by the partner. It should // be autenticated with a service account. // // - parent: The parent, the partner that can resell. Format: @@ -2267,9 +2266,9 @@ type PartnersSubscriptionsCancelCall struct { header_ http.Header } -// Cancel: Used by partners to cancel a subscription service either immediately -// or by the end of the current billing cycle for their customers. It should be -// called directly by the partner using service accounts. +// Cancel: Cancels a subscription service either immediately or by the end of +// the current billing cycle for their customers. It should be called directly +// by the partner using service accounts. // // - name: The name of the subscription resource to be cancelled. It will have // the format of "partners/{partner_id}/subscriptions/{subscription_id}". @@ -2491,10 +2490,9 @@ type PartnersSubscriptionsEntitleCall struct { header_ http.Header } -// Entitle: Used by partners to entitle a previously provisioned subscription -// to the current end user. The end user identity is inferred from the -// authorized credential of the request. This API must be authorized by the end -// user using OAuth. +// Entitle: Entitles a previously provisioned subscription to the current end +// user. The end user identity is inferred from the authorized credential of +// the request. This API must be authorized by the end user using OAuth. // // - name: The name of the subscription resource that is entitled to the // current end user. It will have the format of @@ -2601,9 +2599,9 @@ type PartnersSubscriptionsExtendCall struct { } // Extend: [Opt-in only] Most partners should be on auto-extend by default. -// Used by partners to extend a subscription service for their customers on an -// ongoing basis for the subscription to remain active and renewable. It should -// be called directly by the partner using service accounts. +// Extends a subscription service for their customers on an ongoing basis for +// the subscription to remain active and renewable. It should be called +// directly by the partner using service accounts. // // - name: The name of the subscription resource to be extended. It will have // the format of "partners/{partner_id}/subscriptions/{subscription_id}". @@ -2708,8 +2706,8 @@ type PartnersSubscriptionsGetCall struct { header_ http.Header } -// Get: Used by partners to get a subscription by id. It should be called -// directly by the partner using service accounts. +// Get: Gets a subscription by id. It should be called directly by the partner +// using service accounts. // // - name: The name of the subscription resource to retrieve. It will have the // format of "partners/{partner_id}/subscriptions/{subscription_id}". @@ -2939,11 +2937,11 @@ type PartnersSubscriptionsUndoCancelCall struct { header_ http.Header } -// UndoCancel: Revokes the pending cancellation of a subscription, which is -// currently in `STATE_CANCEL_AT_END_OF_CYCLE` state. If the subscription is -// already cancelled, the request will fail. - **This API doesn't apply to -// YouTube subscriptions.** It should be called directly by the partner using -// service accounts. +// UndoCancel: Currently, it is used by **Google One, Play Pass** partners. +// Revokes the pending cancellation of a subscription, which is currently in +// `STATE_CANCEL_AT_END_OF_CYCLE` state. If the subscription is already +// cancelled, the request will fail. It should be called directly by the +// partner using service accounts. // // - name: The name of the subscription resource whose pending cancellation // needs to be undone. It will have the format of @@ -3050,11 +3048,11 @@ type PartnersUserSessionsGenerateCall struct { } // Generate: This API replaces user authorized OAuth consent based APIs -// (Create, Entitle). Generates a short-lived token for a user session based on -// the user intent. You can use the session token to redirect the user to -// Google to finish the signup flow. You can re-generate new session token -// repeatedly for the same request if necessary, regardless of the previous -// tokens being expired or not. +// (Create, Entitle). Issues a timed session token for the given user intent. +// You can use the session token to redirect the user to Google to finish the +// signup flow. You can re-generate new session token repeatedly for the same +// request if necessary, regardless of the previous tokens being expired or +// not. // // - parent: The parent, the partner that can resell. Format: // partners/{partner}. diff --git a/places/v1/places-api.json b/places/v1/places-api.json index e531464ca0..d3832d47b1 100644 --- a/places/v1/places-api.json +++ b/places/v1/places-api.json @@ -280,7 +280,7 @@ } } }, - "revision": "20250309", + "revision": "20250312", "rootUrl": "https://places.googleapis.com/", "schemas": { "GoogleGeoTypeViewport": { @@ -1194,6 +1194,10 @@ "$ref": "GoogleMapsPlacesV1PlacePlusCode", "description": "Plus code of the place location lat/long." }, + "postalAddress": { + "$ref": "GoogleTypePostalAddress", + "description": "The address in postal address format." + }, "priceLevel": { "description": "Price level of the place.", "enum": [ @@ -1707,7 +1711,7 @@ "type": "object" }, "GoogleMapsPlacesV1PlaceSubDestination": { - "description": "Sub destinations are specific places associated with a main place. These provide more specific destinations for users who are searching for a large or complex place, like an airport, national park, university, or stadium. For example, sub destinations at an airport might include associated terminals and parking lots. Sub destinations return the place id and place resource name, which can be used in subsequent Place Details (New) requests to fetch richer details, including the sub destination's displayName and location.", + "description": "Sub-destinations are specific places associated with a main place. These provide more specific destinations for users who are searching inside a large or complex place, like an airport, national park, university, or stadium. For example, sub-destinations at an airport might include associated terminals and parking lots. Sub-destinations return the place ID and place resource name, which can be used in subsequent Place Details (new) requests to fetch richer details, including the sub-destination's display name and location.", "id": "GoogleMapsPlacesV1PlaceSubDestination", "properties": { "id": { @@ -2327,6 +2331,64 @@ }, "type": "object" }, + "GoogleTypePostalAddress": { + "description": "Represents a postal address. For example for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478", + "id": "GoogleTypePostalAddress", + "properties": { + "addressLines": { + "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (For example \"Austin, TX\"), it is important that the line order is clear. The order of address lines should be \"envelope order\" for the country/region of the address. In places where this can vary (For example Japan), address_language is used to make it explicit (For example \"ja\" for large-to-small ordering and \"ja-Latn\" or \"en\" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).", + "items": { + "type": "string" + }, + "type": "array" + }, + "administrativeArea": { + "description": "Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (For example \"Barcelona\" and not \"Catalonia\"). Many countries don't use an administrative area in postal addresses. For example in Switzerland this should be left unpopulated.", + "type": "string" + }, + "languageCode": { + "description": "Optional. BCP-47 language code of the contents of this address (if known). This is often the UI language of the input form or is expected to match one of the languages used in the address' country/region, or their transliterated equivalents. This can affect formatting in certain countries, but is not critical to the correctness of the data and will never affect any validation or other non-formatting related operations. If this value is not known, it should be omitted (rather than specifying a possibly incorrect default). Examples: \"zh-Hant\", \"ja\", \"ja-Latn\", \"en\".", + "type": "string" + }, + "locality": { + "description": "Optional. Generally refers to the city/town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave locality empty and use address_lines.", + "type": "string" + }, + "organization": { + "description": "Optional. The name of the organization at the address.", + "type": "string" + }, + "postalCode": { + "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).", + "type": "string" + }, + "recipients": { + "description": "Optional. The recipient at the address. This field may, under certain circumstances, contain multiline information. For example, it might contain \"care of\" information.", + "items": { + "type": "string" + }, + "type": "array" + }, + "regionCode": { + "description": "Required. CLDR region code of the country/region of the address. This is never inferred and it is up to the user to ensure the value is correct. See https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: \"CH\" for Switzerland.", + "type": "string" + }, + "revision": { + "description": "The schema revision of the `PostalAddress`. This must be set to 0, which is the latest revision. All new revisions **must** be backward compatible with old revisions.", + "format": "int32", + "type": "integer" + }, + "sortingCode": { + "description": "Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like \"CEDEX\", optionally followed by a number (For example \"CEDEX 7\"), or just a number alone, representing the \"sector code\" (Jamaica), \"delivery area indicator\" (Malawi) or \"post office indicator\" (For example Côte d'Ivoire).", + "type": "string" + }, + "sublocality": { + "description": "Optional. Sublocality of the address. For example, this can be neighborhoods, boroughs, districts.", + "type": "string" + } + }, + "type": "object" + }, "GoogleTypeTimeZone": { "description": "Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones).", "id": "GoogleTypeTimeZone", diff --git a/places/v1/places-gen.go b/places/v1/places-gen.go index 321f46349d..902fa959fa 100644 --- a/places/v1/places-gen.go +++ b/places/v1/places-gen.go @@ -1425,6 +1425,8 @@ type GoogleMapsPlacesV1Place struct { Photos []*GoogleMapsPlacesV1Photo `json:"photos,omitempty"` // PlusCode: Plus code of the place location lat/long. PlusCode *GoogleMapsPlacesV1PlacePlusCode `json:"plusCode,omitempty"` + // PostalAddress: The address in postal address format. + PostalAddress *GoogleTypePostalAddress `json:"postalAddress,omitempty"` // PriceLevel: Price level of the place. // // Possible values: @@ -2021,14 +2023,14 @@ func (s GoogleMapsPlacesV1PlacePlusCode) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleMapsPlacesV1PlaceSubDestination: Sub destinations are specific places +// GoogleMapsPlacesV1PlaceSubDestination: Sub-destinations are specific places // associated with a main place. These provide more specific destinations for -// users who are searching for a large or complex place, like an airport, -// national park, university, or stadium. For example, sub destinations at an -// airport might include associated terminals and parking lots. Sub -// destinations return the place id and place resource name, which can be used -// in subsequent Place Details (New) requests to fetch richer details, -// including the sub destination's displayName and location. +// users who are searching inside a large or complex place, like an airport, +// national park, university, or stadium. For example, sub-destinations at an +// airport might include associated terminals and parking lots. +// Sub-destinations return the place ID and place resource name, which can be +// used in subsequent Place Details (new) requests to fetch richer details, +// including the sub-destination's display name and location. type GoogleMapsPlacesV1PlaceSubDestination struct { // Id: The place id of the sub destination. Id string `json:"id,omitempty"` @@ -3009,6 +3011,107 @@ func (s GoogleTypeMoney) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleTypePostalAddress: Represents a postal address. For example for postal +// delivery or payments addresses. Given a postal address, a postal service can +// deliver items to a premise, P.O. Box or similar. It is not intended to model +// geographical locations (roads, towns, mountains). In typical usage an +// address would be created by user input or from importing existing data, +// depending on the type of process. Advice on address input / editing: - Use +// an internationalization-ready address widget such as +// https://github.com/google/libaddressinput) - Users should not be presented +// with UI elements for input or editing of fields outside countries where that +// field is used. For more guidance on how to use this schema, see: +// https://support.google.com/business/answer/6397478 +type GoogleTypePostalAddress struct { + // AddressLines: Unstructured address lines describing the lower levels of an + // address. Because values in address_lines do not have type information and + // may sometimes contain multiple values in a single field (For example + // "Austin, TX"), it is important that the line order is clear. The order of + // address lines should be "envelope order" for the country/region of the + // address. In places where this can vary (For example Japan), address_language + // is used to make it explicit (For example "ja" for large-to-small ordering + // and "ja-Latn" or "en" for small-to-large). This way, the most specific line + // of an address can be selected based on the language. The minimum permitted + // structural representation of an address consists of a region_code with all + // remaining information placed in the address_lines. It would be possible to + // format such an address very approximately without geocoding, but no semantic + // reasoning could be made about any of the address components until it was at + // least partially resolved. Creating an address only containing a region_code + // and address_lines, and then geocoding is the recommended way to handle + // completely unstructured addresses (as opposed to guessing which parts of the + // address should be localities or administrative areas). + AddressLines []string `json:"addressLines,omitempty"` + // AdministrativeArea: Optional. Highest administrative subdivision which is + // used for postal addresses of a country or region. For example, this can be a + // state, a province, an oblast, or a prefecture. Specifically, for Spain this + // is the province and not the autonomous community (For example "Barcelona" + // and not "Catalonia"). Many countries don't use an administrative area in + // postal addresses. For example in Switzerland this should be left + // unpopulated. + AdministrativeArea string `json:"administrativeArea,omitempty"` + // LanguageCode: Optional. BCP-47 language code of the contents of this address + // (if known). This is often the UI language of the input form or is expected + // to match one of the languages used in the address' country/region, or their + // transliterated equivalents. This can affect formatting in certain countries, + // but is not critical to the correctness of the data and will never affect any + // validation or other non-formatting related operations. If this value is not + // known, it should be omitted (rather than specifying a possibly incorrect + // default). Examples: "zh-Hant", "ja", "ja-Latn", "en". + LanguageCode string `json:"languageCode,omitempty"` + // Locality: Optional. Generally refers to the city/town portion of the + // address. Examples: US city, IT comune, UK post town. In regions of the world + // where localities are not well defined or do not fit into this structure + // well, leave locality empty and use address_lines. + Locality string `json:"locality,omitempty"` + // Organization: Optional. The name of the organization at the address. + Organization string `json:"organization,omitempty"` + // PostalCode: Optional. Postal code of the address. Not all countries use or + // require postal codes to be present, but where they are used, they may + // trigger additional validation with other parts of the address (For example + // state/zip validation in the U.S.A.). + PostalCode string `json:"postalCode,omitempty"` + // Recipients: Optional. The recipient at the address. This field may, under + // certain circumstances, contain multiline information. For example, it might + // contain "care of" information. + Recipients []string `json:"recipients,omitempty"` + // RegionCode: Required. CLDR region code of the country/region of the address. + // This is never inferred and it is up to the user to ensure the value is + // correct. See https://cldr.unicode.org/ and + // https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html + // for details. Example: "CH" for Switzerland. + RegionCode string `json:"regionCode,omitempty"` + // Revision: The schema revision of the `PostalAddress`. This must be set to 0, + // which is the latest revision. All new revisions **must** be backward + // compatible with old revisions. + Revision int64 `json:"revision,omitempty"` + // SortingCode: Optional. Additional, country-specific, sorting code. This is + // not used in most regions. Where it is used, the value is either a string + // like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or + // just a number alone, representing the "sector code" (Jamaica), "delivery + // area indicator" (Malawi) or "post office indicator" (For example Côte + // d'Ivoire). + SortingCode string `json:"sortingCode,omitempty"` + // Sublocality: Optional. Sublocality of the address. For example, this can be + // neighborhoods, boroughs, districts. + Sublocality string `json:"sublocality,omitempty"` + // ForceSendFields is a list of field names (e.g. "AddressLines") 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. "AddressLines") 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 GoogleTypePostalAddress) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypePostalAddress + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone Database // (https://www.iana.org/time-zones). type GoogleTypeTimeZone struct { diff --git a/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json b/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json index 883270ccc2..0af9d0def2 100644 --- a/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json +++ b/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json @@ -773,6 +773,63 @@ } } }, + "lmkrate": { + "methods": { + "get": { + "description": "Describes the properties of the metric set.", + "flatPath": "v1alpha1/apps/{appsId}/lmkRateMetricSet", + "httpMethod": "GET", + "id": "playdeveloperreporting.vitals.lmkrate.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name. Format: apps/{app}/lmkRateMetricSet", + "location": "path", + "pattern": "^apps/[^/]+/lmkRateMetricSet$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+name}", + "response": { + "$ref": "GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet" + }, + "scopes": [ + "https://www.googleapis.com/auth/playdeveloperreporting" + ] + }, + "query": { + "description": "Queries the metrics in the metric set.", + "flatPath": "v1alpha1/apps/{appsId}/lmkRateMetricSet:query", + "httpMethod": "POST", + "id": "playdeveloperreporting.vitals.lmkrate.query", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name. Format: apps/{app}/lmkRateMetricSet", + "location": "path", + "pattern": "^apps/[^/]+/lmkRateMetricSet$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+name}:query", + "request": { + "$ref": "GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest" + }, + "response": { + "$ref": "GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/playdeveloperreporting" + ] + } + } + }, "slowrenderingrate": { "methods": { "get": { @@ -947,7 +1004,7 @@ } } }, - "revision": "20250204", + "revision": "20250311", "rootUrl": "https://playdeveloperreporting.googleapis.com/", "schemas": { "GooglePlayDeveloperReportingV1alpha1Anomaly": { @@ -1367,6 +1424,21 @@ }, "type": "object" }, + "GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet": { + "description": "Singleton resource representing the set of LMK (Low Memory Kill) metrics. This metric set contains LMKs data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `userPerceivedLmkRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one LMK while they were actively using your app (a user-perceived LMK). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `userPerceivedLmkRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device, e.g., 26. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. The form of the identifier is 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral. * `deviceBrand` (string): unique identifier of the user's device brand, e.g., google. * `deviceType` (string): the type (also known as form factor) of the user's device, e.g., PHONE. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains normalized metrics about crashes, another stability metric. * vitals.errors contains normalized metrics about ANRs, another stability metric.", + "id": "GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet", + "properties": { + "freshnessInfo": { + "$ref": "GooglePlayDeveloperReportingV1alpha1FreshnessInfo", + "description": "Summary about data freshness in this resource." + }, + "name": { + "description": "Identifier. The resource name. Format: apps/{app}/lmkRateMetricSet", + "type": "string" + } + }, + "type": "object" + }, "GooglePlayDeveloperReportingV1alpha1MetricValue": { "description": "Represents the value of a metric.", "id": "GooglePlayDeveloperReportingV1alpha1MetricValue", @@ -1711,6 +1783,78 @@ }, "type": "object" }, + "GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest": { + "description": "Request message for QueryLmkRateMetricSet.", + "id": "GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest", + "properties": { + "dimensions": { + "description": "Optional. Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device, e.g., 26. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. The form of the identifier is 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral. * `deviceBrand` (string): unique identifier of the user's device brand, e.g., google. * `deviceType` (string): the type (also known as form factor) of the user's device, e.g., PHONE. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "items": { + "type": "string" + }, + "type": "array" + }, + "filter": { + "description": "Optional. Filters to apply to data. The filtering expression follows [AIP-160](https://google.aip.dev/160) standard and supports filtering by equality of all breakdown dimensions.", + "type": "string" + }, + "metrics": { + "description": "Optional. Metrics to aggregate. **Supported metrics:** * `userPerceivedLmkRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one LMK while they were actively using your app (a user-perceived LMK). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `userPerceivedLmkRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value.", + "items": { + "type": "string" + }, + "type": "array" + }, + "pageSize": { + "description": "Optional. Maximum size of the returned data. If unspecified, at most 1000 rows will be returned. The maximum value is 100,000; values above 100,000 will be coerced to 100,000.", + "format": "int32", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to the request must match the call that provided the page token.", + "type": "string" + }, + "timelineSpec": { + "$ref": "GooglePlayDeveloperReportingV1alpha1TimelineSpec", + "description": "Optional. Specification of the timeline aggregation parameters. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the default and only supported timezone is `America/Los_Angeles`." + }, + "userCohort": { + "description": "Optional. User view to select. The output data will correspond to the selected view. **Supported values:** * `OS_PUBLIC` To select data from all publicly released Android versions. This is the default. Supports all the above dimensions. * `APP_TESTERS` To select data from users who have opted in to be testers. Supports all the above dimensions. * `OS_BETA` To select data from beta android versions only, excluding data from released android versions. Only the following dimensions are supported: * `versionCode` (int64): version of the app that was running on the user's device. * `osBuild` (string): OS build of the user's device, e.g., \"T1B2.220916.004\".", + "enum": [ + "USER_COHORT_UNSPECIFIED", + "OS_PUBLIC", + "OS_BETA", + "APP_TESTERS" + ], + "enumDescriptions": [ + "Unspecified User cohort. This will automatically choose the default value.", + "This is default view. Contains data from public released android versions only.", + "This is the view with just android beta data excluding released OS version data.", + "This is the view with data only from users who have opted in to be testers for a given app, excluding OS beta data." + ], + "type": "string" + } + }, + "type": "object" + }, + "GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse": { + "description": "Response message for QueryLmkRateMetricSet.", + "id": "GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse", + "properties": { + "nextPageToken": { + "description": "Continuation token to fetch the next page of data.", + "type": "string" + }, + "rows": { + "description": "Returned rows of data.", + "items": { + "$ref": "GooglePlayDeveloperReportingV1alpha1MetricsRow" + }, + "type": "array" + } + }, + "type": "object" + }, "GooglePlayDeveloperReportingV1alpha1QuerySlowRenderingRateMetricSetRequest": { "description": "Request message for QuerySlowRenderingRateMetricSet.", "id": "GooglePlayDeveloperReportingV1alpha1QuerySlowRenderingRateMetricSetRequest", diff --git a/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go b/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go index ec0701bc59..246a805ccb 100644 --- a/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go +++ b/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go @@ -186,6 +186,7 @@ func NewVitalsService(s *Service) *VitalsService { rs.Crashrate = NewVitalsCrashrateService(s) rs.Errors = NewVitalsErrorsService(s) rs.Excessivewakeuprate = NewVitalsExcessivewakeuprateService(s) + rs.Lmkrate = NewVitalsLmkrateService(s) rs.Slowrenderingrate = NewVitalsSlowrenderingrateService(s) rs.Slowstartrate = NewVitalsSlowstartrateService(s) rs.Stuckbackgroundwakelockrate = NewVitalsStuckbackgroundwakelockrateService(s) @@ -203,6 +204,8 @@ type VitalsService struct { Excessivewakeuprate *VitalsExcessivewakeuprateService + Lmkrate *VitalsLmkrateService + Slowrenderingrate *VitalsSlowrenderingrateService Slowstartrate *VitalsSlowstartrateService @@ -282,6 +285,15 @@ type VitalsExcessivewakeuprateService struct { s *Service } +func NewVitalsLmkrateService(s *Service) *VitalsLmkrateService { + rs := &VitalsLmkrateService{s: s} + return rs +} + +type VitalsLmkrateService struct { + s *Service +} + func NewVitalsSlowrenderingrateService(s *Service) *VitalsSlowrenderingrateService { rs := &VitalsSlowrenderingrateService{s: s} return rs @@ -1131,6 +1143,88 @@ func (s GooglePlayDeveloperReportingV1alpha1ListAnomaliesResponse) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet: Singleton resource +// representing the set of LMK (Low Memory Kill) metrics. This metric set +// contains LMKs data combined with usage data to produce a normalized metric +// independent of user counts. **Supported aggregation periods:** * DAILY: +// metrics are aggregated in calendar date intervals. Due to historical +// constraints, the only supported timezone is `America/Los_Angeles`. +// **Supported metrics:** * `userPerceivedLmkRate` (`google.type.Decimal`): +// Percentage of distinct users in the aggregation period that experienced at +// least one LMK while they were actively using your app (a user-perceived +// LMK). An app is considered to be in active use if it is displaying any +// activity or executing any foreground service. * +// `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): Rolling +// average value of `userPerceivedLmkRate` in the last 7 days. The daily values +// are weighted by the count of distinct users for the day. * +// `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling +// average value of `userPerceivedLmkRate` in the last 28 days. The daily +// values are weighted by the count of distinct users for the day. * +// `distinctUsers` (`google.type.Decimal`): Count of distinct users in the +// aggregation period that were used as normalization value for the +// `userPerceivedLmkRate` metrics. A user is counted in this metric if they +// used the app in the foreground during the aggregation period. Care must be +// taken not to aggregate this count further, as it may result in users being +// counted multiple times. The value is rounded to the nearest multiple of 10, +// 100, 1,000 or 1,000,000, depending on the magnitude of the value. +// **Supported dimensions:** * `apiLevel` (string): the API level of Android +// that was running on the user's device, e.g., 26. * `versionCode` (int64): +// version of the app that was running on the user's device. * `deviceModel` +// (string): unique identifier of the user's device model. The form of the +// identifier is 'deviceBrand/device', where deviceBrand corresponds to +// Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral. * +// `deviceBrand` (string): unique identifier of the user's device brand, e.g., +// google. * `deviceType` (string): the type (also known as form factor) of the +// user's device, e.g., PHONE. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a 2-letter +// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): +// RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` +// (string): Make of the device's primary system-on-chip, e.g., Samsung. +// Reference +// (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) +// * `deviceSocModel` (string): Model of the device's primary system-on-chip, +// e.g., "Exynos 2100". Reference +// (https://developer.android.com/reference/android/os/Build#SOC_MODEL) * +// `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * +// `deviceCpuModel` (string): Model of the device's CPU, e.g., "Kryo 240". * +// `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * +// `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * +// `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * +// `deviceVulkanVersion` (string): Vulkan version of the device, e.g., +// "4198400". * `deviceGlEsVersion` (string): OpenGL ES version of the device, +// e.g., "196610". * `deviceScreenSize` (string): Screen size of the device, +// e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the +// device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, +// the calling user needs the _View app information (read-only)_ permission for +// the app. **Related metric sets:** * vitals.errors contains normalized +// metrics about crashes, another stability metric. * vitals.errors contains +// normalized metrics about ANRs, another stability metric. +type GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet struct { + // FreshnessInfo: Summary about data freshness in this resource. + FreshnessInfo *GooglePlayDeveloperReportingV1alpha1FreshnessInfo `json:"freshnessInfo,omitempty"` + // Name: Identifier. The resource name. Format: apps/{app}/lmkRateMetricSet + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "FreshnessInfo") 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. "FreshnessInfo") 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 GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet) MarshalJSON() ([]byte, error) { + type NoMethod GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePlayDeveloperReportingV1alpha1MetricValue: Represents the value of a // metric. type GooglePlayDeveloperReportingV1alpha1MetricValue struct { @@ -1740,6 +1834,141 @@ func (s GooglePlayDeveloperReportingV1alpha1QueryExcessiveWakeupRateMetricSetRes return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest: Request +// message for QueryLmkRateMetricSet. +type GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest struct { + // Dimensions: Optional. Dimensions to slice the metrics by. **Supported + // dimensions:** * `apiLevel` (string): the API level of Android that was + // running on the user's device, e.g., 26. * `versionCode` (int64): version of + // the app that was running on the user's device. * `deviceModel` (string): + // unique identifier of the user's device model. The form of the identifier is + // 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and + // device corresponds to Build.DEVICE, e.g., google/coral. * `deviceBrand` + // (string): unique identifier of the user's device brand, e.g., google. * + // `deviceType` (string): the type (also known as form factor) of the user's + // device, e.g., PHONE. * `countryCode` (string): the country or region of the + // user's device based on their IP address, represented as a 2-letter ISO-3166 + // code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of + // the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): + // Make of the device's primary system-on-chip, e.g., Samsung. Reference + // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) + // * `deviceSocModel` (string): Model of the device's primary system-on-chip, + // e.g., "Exynos 2100". Reference + // (https://developer.android.com/reference/android/os/Build#SOC_MODEL) * + // `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * + // `deviceCpuModel` (string): Model of the device's CPU, e.g., "Kryo 240". * + // `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * + // `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * + // `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * + // `deviceVulkanVersion` (string): Vulkan version of the device, e.g., + // "4198400". * `deviceGlEsVersion` (string): OpenGL ES version of the device, + // e.g., "196610". * `deviceScreenSize` (string): Screen size of the device, + // e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the + // device, e.g., mdpi, hdpi. + Dimensions []string `json:"dimensions,omitempty"` + // Filter: Optional. Filters to apply to data. The filtering expression follows + // AIP-160 (https://google.aip.dev/160) standard and supports filtering by + // equality of all breakdown dimensions. + Filter string `json:"filter,omitempty"` + // Metrics: Optional. Metrics to aggregate. **Supported metrics:** * + // `userPerceivedLmkRate` (`google.type.Decimal`): Percentage of distinct users + // in the aggregation period that experienced at least one LMK while they were + // actively using your app (a user-perceived LMK). An app is considered to be + // in active use if it is displaying any activity or executing any foreground + // service. * `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): + // Rolling average value of `userPerceivedLmkRate` in the last 7 days. The + // daily values are weighted by the count of distinct users for the day. * + // `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling + // average value of `userPerceivedLmkRate` in the last 28 days. The daily + // values are weighted by the count of distinct users for the day. * + // `distinctUsers` (`google.type.Decimal`): Count of distinct users in the + // aggregation period that were used as normalization value for the + // `userPerceivedLmkRate` metrics. A user is counted in this metric if they + // used the app in the foreground during the aggregation period. Care must be + // taken not to aggregate this count further, as it may result in users being + // counted multiple times. The value is rounded to the nearest multiple of 10, + // 100, 1,000 or 1,000,000, depending on the magnitude of the value. + Metrics []string `json:"metrics,omitempty"` + // PageSize: Optional. Maximum size of the returned data. If unspecified, at + // most 1000 rows will be returned. The maximum value is 100,000; values above + // 100,000 will be coerced to 100,000. + PageSize int64 `json:"pageSize,omitempty"` + // PageToken: Optional. A page token, received from a previous call. Provide + // this to retrieve the subsequent page. When paginating, all other parameters + // provided to the request must match the call that provided the page token. + PageToken string `json:"pageToken,omitempty"` + // TimelineSpec: Optional. Specification of the timeline aggregation + // parameters. **Supported aggregation periods:** * DAILY: metrics are + // aggregated in calendar date intervals. Due to historical constraints, the + // default and only supported timezone is `America/Los_Angeles`. + TimelineSpec *GooglePlayDeveloperReportingV1alpha1TimelineSpec `json:"timelineSpec,omitempty"` + // UserCohort: Optional. User view to select. The output data will correspond + // to the selected view. **Supported values:** * `OS_PUBLIC` To select data + // from all publicly released Android versions. This is the default. Supports + // all the above dimensions. * `APP_TESTERS` To select data from users who have + // opted in to be testers. Supports all the above dimensions. * `OS_BETA` To + // select data from beta android versions only, excluding data from released + // android versions. Only the following dimensions are supported: * + // `versionCode` (int64): version of the app that was running on the user's + // device. * `osBuild` (string): OS build of the user's device, e.g., + // "T1B2.220916.004". + // + // Possible values: + // "USER_COHORT_UNSPECIFIED" - Unspecified User cohort. This will + // automatically choose the default value. + // "OS_PUBLIC" - This is default view. Contains data from public released + // android versions only. + // "OS_BETA" - This is the view with just android beta data excluding + // released OS version data. + // "APP_TESTERS" - This is the view with data only from users who have opted + // in to be testers for a given app, excluding OS beta data. + UserCohort string `json:"userCohort,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dimensions") 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. "Dimensions") 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 GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest) MarshalJSON() ([]byte, error) { + type NoMethod GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse: Response +// message for QueryLmkRateMetricSet. +type GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse struct { + // NextPageToken: Continuation token to fetch the next page of data. + NextPageToken string `json:"nextPageToken,omitempty"` + // Rows: Returned rows of data. + Rows []*GooglePlayDeveloperReportingV1alpha1MetricsRow `json:"rows,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse) MarshalJSON() ([]byte, error) { + type NoMethod GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePlayDeveloperReportingV1alpha1QuerySlowRenderingRateMetricSetRequest: // Request message for QuerySlowRenderingRateMetricSet. type GooglePlayDeveloperReportingV1alpha1QuerySlowRenderingRateMetricSetRequest struct { @@ -4838,6 +5067,241 @@ func (c *VitalsExcessivewakeuprateQueryCall) Pages(ctx context.Context, f func(* } } +type VitalsLmkrateGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Describes the properties of the metric set. +// +// - name: The resource name. Format: apps/{app}/lmkRateMetricSet. +func (r *VitalsLmkrateService) Get(name string) *VitalsLmkrateGetCall { + c := &VitalsLmkrateGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *VitalsLmkrateGetCall) Fields(s ...googleapi.Field) *VitalsLmkrateGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *VitalsLmkrateGetCall) IfNoneMatch(entityTag string) *VitalsLmkrateGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *VitalsLmkrateGetCall) Context(ctx context.Context) *VitalsLmkrateGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *VitalsLmkrateGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *VitalsLmkrateGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "playdeveloperreporting.vitals.lmkrate.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *VitalsLmkrateGetCall) Do(opts ...googleapi.CallOption) (*GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GooglePlayDeveloperReportingV1alpha1LmkRateMetricSet{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type VitalsLmkrateQueryCall struct { + s *Service + name string + googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest *GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Query: Queries the metrics in the metric set. +// +// - name: The resource name. Format: apps/{app}/lmkRateMetricSet. +func (r *VitalsLmkrateService) Query(name string, googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest *GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetRequest) *VitalsLmkrateQueryCall { + c := &VitalsLmkrateQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest = googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *VitalsLmkrateQueryCall) Fields(s ...googleapi.Field) *VitalsLmkrateQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *VitalsLmkrateQueryCall) Context(ctx context.Context) *VitalsLmkrateQueryCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *VitalsLmkrateQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *VitalsLmkrateQueryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha1/{+name}:query") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.query", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "playdeveloperreporting.vitals.lmkrate.query" call. +// Any non-2xx status code is an error. Response headers are in either +// *GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse.ServerResp +// onse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *VitalsLmkrateQueryCall) Do(opts ...googleapi.CallOption) (*GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.query", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *VitalsLmkrateQueryCall) Pages(ctx context.Context, f func(*GooglePlayDeveloperReportingV1alpha1QueryLmkRateMetricSetResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest.PageToken = pt }(c.googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest.PageToken) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.googleplaydeveloperreportingv1alpha1querylmkratemetricsetrequest.PageToken = x.NextPageToken + } +} + type VitalsSlowrenderingrateGetCall struct { s *Service name string diff --git a/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json b/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json index 4c27ea4212..a35aa9915a 100644 --- a/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json +++ b/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json @@ -773,6 +773,63 @@ } } }, + "lmkrate": { + "methods": { + "get": { + "description": "Describes the properties of the metric set.", + "flatPath": "v1beta1/apps/{appsId}/lmkRateMetricSet", + "httpMethod": "GET", + "id": "playdeveloperreporting.vitals.lmkrate.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name. Format: apps/{app}/lmkRateMetricSet", + "location": "path", + "pattern": "^apps/[^/]+/lmkRateMetricSet$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "GooglePlayDeveloperReportingV1beta1LmkRateMetricSet" + }, + "scopes": [ + "https://www.googleapis.com/auth/playdeveloperreporting" + ] + }, + "query": { + "description": "Queries the metrics in the metric set.", + "flatPath": "v1beta1/apps/{appsId}/lmkRateMetricSet:query", + "httpMethod": "POST", + "id": "playdeveloperreporting.vitals.lmkrate.query", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name. Format: apps/{app}/lmkRateMetricSet", + "location": "path", + "pattern": "^apps/[^/]+/lmkRateMetricSet$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:query", + "request": { + "$ref": "GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest" + }, + "response": { + "$ref": "GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/playdeveloperreporting" + ] + } + } + }, "slowrenderingrate": { "methods": { "get": { @@ -947,7 +1004,7 @@ } } }, - "revision": "20250204", + "revision": "20250311", "rootUrl": "https://playdeveloperreporting.googleapis.com/", "schemas": { "GooglePlayDeveloperReportingV1beta1Anomaly": { @@ -1367,6 +1424,21 @@ }, "type": "object" }, + "GooglePlayDeveloperReportingV1beta1LmkRateMetricSet": { + "description": "Singleton resource representing the set of LMK (Low Memory Kill) metrics. This metric set contains LMKs data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `userPerceivedLmkRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one LMK while they were actively using your app (a user-perceived LMK). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `userPerceivedLmkRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device, e.g., 26. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. The form of the identifier is 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral. * `deviceBrand` (string): unique identifier of the user's device brand, e.g., google. * `deviceType` (string): the type (also known as form factor) of the user's device, e.g., PHONE. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains normalized metrics about crashes, another stability metric. * vitals.errors contains normalized metrics about ANRs, another stability metric.", + "id": "GooglePlayDeveloperReportingV1beta1LmkRateMetricSet", + "properties": { + "freshnessInfo": { + "$ref": "GooglePlayDeveloperReportingV1beta1FreshnessInfo", + "description": "Summary about data freshness in this resource." + }, + "name": { + "description": "Identifier. The resource name. Format: apps/{app}/lmkRateMetricSet", + "type": "string" + } + }, + "type": "object" + }, "GooglePlayDeveloperReportingV1beta1MetricValue": { "description": "Represents the value of a metric.", "id": "GooglePlayDeveloperReportingV1beta1MetricValue", @@ -1711,6 +1783,78 @@ }, "type": "object" }, + "GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest": { + "description": "Request message for QueryLmkRateMetricSet.", + "id": "GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest", + "properties": { + "dimensions": { + "description": "Optional. Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device, e.g., 26. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. The form of the identifier is 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral. * `deviceBrand` (string): unique identifier of the user's device brand, e.g., google. * `deviceType` (string): the type (also known as form factor) of the user's device, e.g., PHONE. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "items": { + "type": "string" + }, + "type": "array" + }, + "filter": { + "description": "Optional. Filters to apply to data. The filtering expression follows [AIP-160](https://google.aip.dev/160) standard and supports filtering by equality of all breakdown dimensions.", + "type": "string" + }, + "metrics": { + "description": "Optional. Metrics to aggregate. **Supported metrics:** * `userPerceivedLmkRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one LMK while they were actively using your app (a user-perceived LMK). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedLmkRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `userPerceivedLmkRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value.", + "items": { + "type": "string" + }, + "type": "array" + }, + "pageSize": { + "description": "Optional. Maximum size of the returned data. If unspecified, at most 1000 rows will be returned. The maximum value is 100,000; values above 100,000 will be coerced to 100,000.", + "format": "int32", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to the request must match the call that provided the page token.", + "type": "string" + }, + "timelineSpec": { + "$ref": "GooglePlayDeveloperReportingV1beta1TimelineSpec", + "description": "Optional. Specification of the timeline aggregation parameters. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the default and only supported timezone is `America/Los_Angeles`." + }, + "userCohort": { + "description": "Optional. User view to select. The output data will correspond to the selected view. **Supported values:** * `OS_PUBLIC` To select data from all publicly released Android versions. This is the default. Supports all the above dimensions. * `APP_TESTERS` To select data from users who have opted in to be testers. Supports all the above dimensions. * `OS_BETA` To select data from beta android versions only, excluding data from released android versions. Only the following dimensions are supported: * `versionCode` (int64): version of the app that was running on the user's device. * `osBuild` (string): OS build of the user's device, e.g., \"T1B2.220916.004\".", + "enum": [ + "USER_COHORT_UNSPECIFIED", + "OS_PUBLIC", + "OS_BETA", + "APP_TESTERS" + ], + "enumDescriptions": [ + "Unspecified User cohort. This will automatically choose the default value.", + "This is default view. Contains data from public released android versions only.", + "This is the view with just android beta data excluding released OS version data.", + "This is the view with data only from users who have opted in to be testers for a given app, excluding OS beta data." + ], + "type": "string" + } + }, + "type": "object" + }, + "GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse": { + "description": "Response message for QueryLmkRateMetricSet.", + "id": "GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse", + "properties": { + "nextPageToken": { + "description": "Continuation token to fetch the next page of data.", + "type": "string" + }, + "rows": { + "description": "Returned rows of data.", + "items": { + "$ref": "GooglePlayDeveloperReportingV1beta1MetricsRow" + }, + "type": "array" + } + }, + "type": "object" + }, "GooglePlayDeveloperReportingV1beta1QuerySlowRenderingRateMetricSetRequest": { "description": "Request message for QuerySlowRenderingRateMetricSet.", "id": "GooglePlayDeveloperReportingV1beta1QuerySlowRenderingRateMetricSetRequest", diff --git a/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go b/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go index 45b0be4284..280c017400 100644 --- a/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go +++ b/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go @@ -186,6 +186,7 @@ func NewVitalsService(s *Service) *VitalsService { rs.Crashrate = NewVitalsCrashrateService(s) rs.Errors = NewVitalsErrorsService(s) rs.Excessivewakeuprate = NewVitalsExcessivewakeuprateService(s) + rs.Lmkrate = NewVitalsLmkrateService(s) rs.Slowrenderingrate = NewVitalsSlowrenderingrateService(s) rs.Slowstartrate = NewVitalsSlowstartrateService(s) rs.Stuckbackgroundwakelockrate = NewVitalsStuckbackgroundwakelockrateService(s) @@ -203,6 +204,8 @@ type VitalsService struct { Excessivewakeuprate *VitalsExcessivewakeuprateService + Lmkrate *VitalsLmkrateService + Slowrenderingrate *VitalsSlowrenderingrateService Slowstartrate *VitalsSlowstartrateService @@ -282,6 +285,15 @@ type VitalsExcessivewakeuprateService struct { s *Service } +func NewVitalsLmkrateService(s *Service) *VitalsLmkrateService { + rs := &VitalsLmkrateService{s: s} + return rs +} + +type VitalsLmkrateService struct { + s *Service +} + func NewVitalsSlowrenderingrateService(s *Service) *VitalsSlowrenderingrateService { rs := &VitalsSlowrenderingrateService{s: s} return rs @@ -1131,6 +1143,88 @@ func (s GooglePlayDeveloperReportingV1beta1ListAnomaliesResponse) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePlayDeveloperReportingV1beta1LmkRateMetricSet: Singleton resource +// representing the set of LMK (Low Memory Kill) metrics. This metric set +// contains LMKs data combined with usage data to produce a normalized metric +// independent of user counts. **Supported aggregation periods:** * DAILY: +// metrics are aggregated in calendar date intervals. Due to historical +// constraints, the only supported timezone is `America/Los_Angeles`. +// **Supported metrics:** * `userPerceivedLmkRate` (`google.type.Decimal`): +// Percentage of distinct users in the aggregation period that experienced at +// least one LMK while they were actively using your app (a user-perceived +// LMK). An app is considered to be in active use if it is displaying any +// activity or executing any foreground service. * +// `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): Rolling +// average value of `userPerceivedLmkRate` in the last 7 days. The daily values +// are weighted by the count of distinct users for the day. * +// `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling +// average value of `userPerceivedLmkRate` in the last 28 days. The daily +// values are weighted by the count of distinct users for the day. * +// `distinctUsers` (`google.type.Decimal`): Count of distinct users in the +// aggregation period that were used as normalization value for the +// `userPerceivedLmkRate` metrics. A user is counted in this metric if they +// used the app in the foreground during the aggregation period. Care must be +// taken not to aggregate this count further, as it may result in users being +// counted multiple times. The value is rounded to the nearest multiple of 10, +// 100, 1,000 or 1,000,000, depending on the magnitude of the value. +// **Supported dimensions:** * `apiLevel` (string): the API level of Android +// that was running on the user's device, e.g., 26. * `versionCode` (int64): +// version of the app that was running on the user's device. * `deviceModel` +// (string): unique identifier of the user's device model. The form of the +// identifier is 'deviceBrand/device', where deviceBrand corresponds to +// Build.BRAND and device corresponds to Build.DEVICE, e.g., google/coral. * +// `deviceBrand` (string): unique identifier of the user's device brand, e.g., +// google. * `deviceType` (string): the type (also known as form factor) of the +// user's device, e.g., PHONE. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a 2-letter +// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): +// RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` +// (string): Make of the device's primary system-on-chip, e.g., Samsung. +// Reference +// (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) +// * `deviceSocModel` (string): Model of the device's primary system-on-chip, +// e.g., "Exynos 2100". Reference +// (https://developer.android.com/reference/android/os/Build#SOC_MODEL) * +// `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * +// `deviceCpuModel` (string): Model of the device's CPU, e.g., "Kryo 240". * +// `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * +// `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * +// `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * +// `deviceVulkanVersion` (string): Vulkan version of the device, e.g., +// "4198400". * `deviceGlEsVersion` (string): OpenGL ES version of the device, +// e.g., "196610". * `deviceScreenSize` (string): Screen size of the device, +// e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the +// device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, +// the calling user needs the _View app information (read-only)_ permission for +// the app. **Related metric sets:** * vitals.errors contains normalized +// metrics about crashes, another stability metric. * vitals.errors contains +// normalized metrics about ANRs, another stability metric. +type GooglePlayDeveloperReportingV1beta1LmkRateMetricSet struct { + // FreshnessInfo: Summary about data freshness in this resource. + FreshnessInfo *GooglePlayDeveloperReportingV1beta1FreshnessInfo `json:"freshnessInfo,omitempty"` + // Name: Identifier. The resource name. Format: apps/{app}/lmkRateMetricSet + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "FreshnessInfo") 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. "FreshnessInfo") 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 GooglePlayDeveloperReportingV1beta1LmkRateMetricSet) MarshalJSON() ([]byte, error) { + type NoMethod GooglePlayDeveloperReportingV1beta1LmkRateMetricSet + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePlayDeveloperReportingV1beta1MetricValue: Represents the value of a // metric. type GooglePlayDeveloperReportingV1beta1MetricValue struct { @@ -1740,6 +1834,141 @@ func (s GooglePlayDeveloperReportingV1beta1QueryExcessiveWakeupRateMetricSetResp return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest: Request +// message for QueryLmkRateMetricSet. +type GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest struct { + // Dimensions: Optional. Dimensions to slice the metrics by. **Supported + // dimensions:** * `apiLevel` (string): the API level of Android that was + // running on the user's device, e.g., 26. * `versionCode` (int64): version of + // the app that was running on the user's device. * `deviceModel` (string): + // unique identifier of the user's device model. The form of the identifier is + // 'deviceBrand/device', where deviceBrand corresponds to Build.BRAND and + // device corresponds to Build.DEVICE, e.g., google/coral. * `deviceBrand` + // (string): unique identifier of the user's device brand, e.g., google. * + // `deviceType` (string): the type (also known as form factor) of the user's + // device, e.g., PHONE. * `countryCode` (string): the country or region of the + // user's device based on their IP address, represented as a 2-letter ISO-3166 + // code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of + // the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): + // Make of the device's primary system-on-chip, e.g., Samsung. Reference + // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) + // * `deviceSocModel` (string): Model of the device's primary system-on-chip, + // e.g., "Exynos 2100". Reference + // (https://developer.android.com/reference/android/os/Build#SOC_MODEL) * + // `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * + // `deviceCpuModel` (string): Model of the device's CPU, e.g., "Kryo 240". * + // `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * + // `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * + // `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * + // `deviceVulkanVersion` (string): Vulkan version of the device, e.g., + // "4198400". * `deviceGlEsVersion` (string): OpenGL ES version of the device, + // e.g., "196610". * `deviceScreenSize` (string): Screen size of the device, + // e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the + // device, e.g., mdpi, hdpi. + Dimensions []string `json:"dimensions,omitempty"` + // Filter: Optional. Filters to apply to data. The filtering expression follows + // AIP-160 (https://google.aip.dev/160) standard and supports filtering by + // equality of all breakdown dimensions. + Filter string `json:"filter,omitempty"` + // Metrics: Optional. Metrics to aggregate. **Supported metrics:** * + // `userPerceivedLmkRate` (`google.type.Decimal`): Percentage of distinct users + // in the aggregation period that experienced at least one LMK while they were + // actively using your app (a user-perceived LMK). An app is considered to be + // in active use if it is displaying any activity or executing any foreground + // service. * `userPerceivedLmkRate7dUserWeighted` (`google.type.Decimal`): + // Rolling average value of `userPerceivedLmkRate` in the last 7 days. The + // daily values are weighted by the count of distinct users for the day. * + // `userPerceivedLmkRate28dUserWeighted` (`google.type.Decimal`): Rolling + // average value of `userPerceivedLmkRate` in the last 28 days. The daily + // values are weighted by the count of distinct users for the day. * + // `distinctUsers` (`google.type.Decimal`): Count of distinct users in the + // aggregation period that were used as normalization value for the + // `userPerceivedLmkRate` metrics. A user is counted in this metric if they + // used the app in the foreground during the aggregation period. Care must be + // taken not to aggregate this count further, as it may result in users being + // counted multiple times. The value is rounded to the nearest multiple of 10, + // 100, 1,000 or 1,000,000, depending on the magnitude of the value. + Metrics []string `json:"metrics,omitempty"` + // PageSize: Optional. Maximum size of the returned data. If unspecified, at + // most 1000 rows will be returned. The maximum value is 100,000; values above + // 100,000 will be coerced to 100,000. + PageSize int64 `json:"pageSize,omitempty"` + // PageToken: Optional. A page token, received from a previous call. Provide + // this to retrieve the subsequent page. When paginating, all other parameters + // provided to the request must match the call that provided the page token. + PageToken string `json:"pageToken,omitempty"` + // TimelineSpec: Optional. Specification of the timeline aggregation + // parameters. **Supported aggregation periods:** * DAILY: metrics are + // aggregated in calendar date intervals. Due to historical constraints, the + // default and only supported timezone is `America/Los_Angeles`. + TimelineSpec *GooglePlayDeveloperReportingV1beta1TimelineSpec `json:"timelineSpec,omitempty"` + // UserCohort: Optional. User view to select. The output data will correspond + // to the selected view. **Supported values:** * `OS_PUBLIC` To select data + // from all publicly released Android versions. This is the default. Supports + // all the above dimensions. * `APP_TESTERS` To select data from users who have + // opted in to be testers. Supports all the above dimensions. * `OS_BETA` To + // select data from beta android versions only, excluding data from released + // android versions. Only the following dimensions are supported: * + // `versionCode` (int64): version of the app that was running on the user's + // device. * `osBuild` (string): OS build of the user's device, e.g., + // "T1B2.220916.004". + // + // Possible values: + // "USER_COHORT_UNSPECIFIED" - Unspecified User cohort. This will + // automatically choose the default value. + // "OS_PUBLIC" - This is default view. Contains data from public released + // android versions only. + // "OS_BETA" - This is the view with just android beta data excluding + // released OS version data. + // "APP_TESTERS" - This is the view with data only from users who have opted + // in to be testers for a given app, excluding OS beta data. + UserCohort string `json:"userCohort,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dimensions") 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. "Dimensions") 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 GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest) MarshalJSON() ([]byte, error) { + type NoMethod GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse: Response +// message for QueryLmkRateMetricSet. +type GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse struct { + // NextPageToken: Continuation token to fetch the next page of data. + NextPageToken string `json:"nextPageToken,omitempty"` + // Rows: Returned rows of data. + Rows []*GooglePlayDeveloperReportingV1beta1MetricsRow `json:"rows,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse) MarshalJSON() ([]byte, error) { + type NoMethod GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePlayDeveloperReportingV1beta1QuerySlowRenderingRateMetricSetRequest: // Request message for QuerySlowRenderingRateMetricSet. type GooglePlayDeveloperReportingV1beta1QuerySlowRenderingRateMetricSetRequest struct { @@ -4838,6 +5067,241 @@ func (c *VitalsExcessivewakeuprateQueryCall) Pages(ctx context.Context, f func(* } } +type VitalsLmkrateGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Describes the properties of the metric set. +// +// - name: The resource name. Format: apps/{app}/lmkRateMetricSet. +func (r *VitalsLmkrateService) Get(name string) *VitalsLmkrateGetCall { + c := &VitalsLmkrateGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *VitalsLmkrateGetCall) Fields(s ...googleapi.Field) *VitalsLmkrateGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *VitalsLmkrateGetCall) IfNoneMatch(entityTag string) *VitalsLmkrateGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *VitalsLmkrateGetCall) Context(ctx context.Context) *VitalsLmkrateGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *VitalsLmkrateGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *VitalsLmkrateGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "playdeveloperreporting.vitals.lmkrate.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GooglePlayDeveloperReportingV1beta1LmkRateMetricSet.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *VitalsLmkrateGetCall) Do(opts ...googleapi.CallOption) (*GooglePlayDeveloperReportingV1beta1LmkRateMetricSet, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GooglePlayDeveloperReportingV1beta1LmkRateMetricSet{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type VitalsLmkrateQueryCall struct { + s *Service + name string + googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest *GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Query: Queries the metrics in the metric set. +// +// - name: The resource name. Format: apps/{app}/lmkRateMetricSet. +func (r *VitalsLmkrateService) Query(name string, googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest *GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetRequest) *VitalsLmkrateQueryCall { + c := &VitalsLmkrateQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest = googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *VitalsLmkrateQueryCall) Fields(s ...googleapi.Field) *VitalsLmkrateQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *VitalsLmkrateQueryCall) Context(ctx context.Context) *VitalsLmkrateQueryCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *VitalsLmkrateQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *VitalsLmkrateQueryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:query") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.query", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "playdeveloperreporting.vitals.lmkrate.query" call. +// Any non-2xx status code is an error. Response headers are in either +// *GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse.ServerRespo +// nse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *VitalsLmkrateQueryCall) Do(opts ...googleapi.CallOption) (*GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "playdeveloperreporting.vitals.lmkrate.query", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *VitalsLmkrateQueryCall) Pages(ctx context.Context, f func(*GooglePlayDeveloperReportingV1beta1QueryLmkRateMetricSetResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest.PageToken = pt }(c.googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest.PageToken) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.googleplaydeveloperreportingv1beta1querylmkratemetricsetrequest.PageToken = x.NextPageToken + } +} + type VitalsSlowrenderingrateGetCall struct { s *Service name string diff --git a/redis/v1/redis-api.json b/redis/v1/redis-api.json index dc69d7eaed..d203300f56 100644 --- a/redis/v1/redis-api.json +++ b/redis/v1/redis-api.json @@ -1067,7 +1067,7 @@ } } }, - "revision": "20250303", + "revision": "20250311", "rootUrl": "https://redis.googleapis.com/", "schemas": { "AOFConfig": { @@ -2124,7 +2124,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -2214,6 +2216,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -2304,7 +2308,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" }, @@ -2713,7 +2719,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -2803,6 +2811,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -2893,7 +2903,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" } diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index f7c8d47439..b2664d7fd7 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -1403,6 +1403,10 @@ type DatabaseResourceHealthSignalData struct { // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1866,6 +1870,10 @@ type DatabaseResourceRecommendationSignalData struct { // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalMetadata") to // unconditionally include in API requests. By default, fields with empty or diff --git a/redis/v1beta1/redis-api.json b/redis/v1beta1/redis-api.json index f3bcc9217f..dc9554189f 100644 --- a/redis/v1beta1/redis-api.json +++ b/redis/v1beta1/redis-api.json @@ -1067,7 +1067,7 @@ } } }, - "revision": "20250303", + "revision": "20250311", "rootUrl": "https://redis.googleapis.com/", "schemas": { "AOFConfig": { @@ -2124,7 +2124,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -2214,6 +2216,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -2304,7 +2308,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" }, @@ -2713,7 +2719,9 @@ "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", - "SIGNAL_TYPE_INEFFICIENT_QUERY" + "SIGNAL_TYPE_INEFFICIENT_QUERY", + "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", + "SIGNAL_TYPE_MEMORY_LIMIT" ], "enumDeprecated": [ false, @@ -2803,6 +2811,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -2893,7 +2903,9 @@ "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", - "Indicates that the instance has inefficient queries detected." + "Indicates that the instance has inefficient queries detected.", + "Indicates that the instance has read intensive workload.", + "Indicates that the instance is nearing memory limit." ], "type": "string" } diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index ae8fb86ff2..56d41ef075 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -1403,6 +1403,10 @@ type DatabaseResourceHealthSignalData struct { // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -1866,6 +1870,10 @@ type DatabaseResourceRecommendationSignalData struct { // the resource // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has // inefficient queries detected. + // "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD" - Indicates that the instance has + // read intensive workload. + // "SIGNAL_TYPE_MEMORY_LIMIT" - Indicates that the instance is nearing memory + // limit. SignalType string `json:"signalType,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalMetadata") to // unconditionally include in API requests. By default, fields with empty or diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index 2f4c3ef1db..e508d6e2c5 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -165,7 +165,7 @@ "type": "string" }, "visitorId": { - "description": "Required field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Recommended field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "location": "query", "type": "string" } @@ -2223,7 +2223,7 @@ } } }, - "revision": "20250227", + "revision": "20250314", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -5214,6 +5214,10 @@ "$ref": "GoogleCloudRetailV2SearchRequestPersonalizationSpec", "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set. SearchRequest.personalization_spec will override ServingConfig.personalization_spec." }, + "placeId": { + "description": "Optional. An id corresponding to a place, such as a store id or region id. When specified, we use the price from the local inventory with the matching product's LocalInventory.place_id for revenue optimization.", + "type": "string" + }, "query": { "description": "Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.", "type": "string" diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index ae71bacf65..d4e9db1973 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -5084,6 +5084,10 @@ type GoogleCloudRetailV2SearchRequest struct { // SearchRequest.personalization_spec will override // ServingConfig.personalization_spec. PersonalizationSpec *GoogleCloudRetailV2SearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` + // PlaceId: Optional. An id corresponding to a place, such as a store id or + // region id. When specified, we use the price from the local inventory with + // the matching product's LocalInventory.place_id for revenue optimization. + PlaceId string `json:"placeId,omitempty"` // Query: Raw search query. If this field is empty, the request is considered a // category browsing request and returned results are based on filter and // page_categories. @@ -8980,13 +8984,13 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Query(query string) *Projec return c } -// VisitorId sets the optional parameter "visitorId": Required field. A unique -// identifier for tracking visitors. For example, this could be implemented -// with an HTTP cookie, which should be able to uniquely identify a visitor on -// a single device. This unique identifier should not change if the visitor -// logs in or out of the website. The field must be a UTF-8 encoded string with -// a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is -// returned. +// VisitorId sets the optional parameter "visitorId": Recommended field. A +// unique identifier for tracking visitors. For example, this could be +// implemented with an HTTP cookie, which should be able to uniquely identify a +// visitor on a single device. This unique identifier should not change if the +// visitor logs in or out of the website. The field must be a UTF-8 encoded +// string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT +// error is returned. func (c *ProjectsLocationsCatalogsCompleteQueryCall) VisitorId(visitorId string) *ProjectsLocationsCatalogsCompleteQueryCall { c.urlParams_.Set("visitorId", visitorId) return c diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 53f80f708c..2f1f086e12 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -363,7 +363,7 @@ "type": "string" }, "visitorId": { - "description": "Required field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Recommended field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "location": "query", "type": "string" } @@ -2061,6 +2061,34 @@ }, "placements": { "methods": { + "conversationalSearch": { + "description": "Performs a conversational search. This feature is only available for users who have Conversational Search enabled.", + "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:conversationalSearch", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.placements.conversationalSearch", + "parameterOrder": [ + "placement" + ], + "parameters": { + "placement": { + "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving config name and the set of models that will be used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2alpha/{+placement}:conversationalSearch", + "request": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequest" + }, + "response": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "predict": { "description": "Makes a recommendation prediction.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:predict", @@ -2149,6 +2177,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "conversationalSearch": { + "description": "Performs a conversational search. This feature is only available for users who have Conversational Search enabled.", + "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:conversationalSearch", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.servingConfigs.conversationalSearch", + "parameterOrder": [ + "placement" + ], + "parameters": { + "placement": { + "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving config name and the set of models that will be used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2alpha/{+placement}:conversationalSearch", + "request": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequest" + }, + "response": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a ServingConfig. A maximum of 100 ServingConfigs are allowed in a Catalog, otherwise a FAILED_PRECONDITION error is returned.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs", @@ -2744,7 +2800,7 @@ } } }, - "revision": "20250227", + "revision": "20250314", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4501,6 +4557,218 @@ }, "type": "object" }, + "GoogleCloudRetailV2alphaConversationalSearchRequest": { + "description": "Request message for ConversationalSearchService.ConversationalSearch method.", + "id": "GoogleCloudRetailV2alphaConversationalSearchRequest", + "properties": { + "branch": { + "description": "Required. The branch resource name, such as `projects/*/locations/global/catalogs/default_catalog/branches/0`. Use \"default_branch\" as the branch ID or leave this field empty, to search products under the default branch.", + "type": "string" + }, + "conversationId": { + "description": "Optional. This field specifies the conversation id, which maintains the state of the conversation between client side and server side. Use the value from the previous ConversationalSearchResponse.conversation_id. For the initial request, this should be empty.", + "type": "string" + }, + "conversationalFilteringSpec": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec", + "description": "Optional. This field specifies all conversational filtering related parameters." + }, + "pageCategories": { + "description": "Optional. The categories associated with a category page. Must be set for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", + "items": { + "type": "string" + }, + "type": "array" + }, + "query": { + "description": "Optional. Raw search query to be searched for. If this field is empty, the request is considered a category browsing request.", + "type": "string" + }, + "searchParams": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams", + "description": "Optional. Search parameters." + }, + "userInfo": { + "$ref": "GoogleCloudRetailV2alphaUserInfo", + "description": "Optional. User information." + }, + "visitorId": { + "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This should be the same identifier as UserEvent.visitor_id. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec": { + "description": "This field specifies all conversational filtering related parameters addition to conversational retail search.", + "id": "GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec", + "properties": { + "conversationalFilteringMode": { + "description": "Optional. Mode to control Conversational Filtering. Defaults to Mode.DISABLED if it's unset.", + "enum": [ + "MODE_UNSPECIFIED", + "CONVERSATIONAL_FILTER_ONLY" + ], + "enumDescriptions": [ + "Default value.", + "Enabled Conversational Filtering without default Conversational Search." + ], + "type": "string" + }, + "enableConversationalFiltering": { + "deprecated": true, + "description": "Optional. This field is deprecated. Please use ConversationalFilteringSpec.conversational_filtering_mode instead.", + "type": "boolean" + }, + "userAnswer": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer", + "description": "Optional. This field specifies the current user answer during the conversational filtering search. It can be either user selected from suggested answers or user input plain text." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams": { + "description": "Search parameters.", + "id": "GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudRetailV2alphaSearchRequestBoostSpec", + "description": "Optional. The boost spec to specify the boosting of search results. The syntax of the boost spec is the same as SearchRequest.boost_spec." + }, + "canonicalFilter": { + "description": "Optional. The canonical filter string to restrict search results. The syntax of the canonical filter string is the same as SearchRequest.canonical_filter.", + "type": "string" + }, + "filter": { + "description": "Optional. The filter string to restrict search results. The syntax of the filter string is the same as SearchRequest.filter.", + "type": "string" + }, + "sortBy": { + "description": "Optional. The sort string to specify the sorting of search results. The syntax of the sort string is the same as SearchRequest.sort.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer": { + "description": "This field specifies the current user answer during the conversational filtering search. This can be either user selected from suggested answers or user input plain text.", + "id": "GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer", + "properties": { + "selectedAnswer": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer", + "description": "Optional. This field specifies the selected answer during the conversational search. This should be a subset of ConversationalSearchResponse.followup_question.suggested_answers." + }, + "textAnswer": { + "description": "This field specifies the incremental input text from the user during the conversational search.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer": { + "description": "This field specifies the selected answers during the conversational search.", + "id": "GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2alphaProductAttributeValue", + "description": "Optional. This field specifies the selected answer which is a attribute key-value." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchResponse": { + "description": "Response message for ConversationalSearchService.ConversationalSearch method.", + "id": "GoogleCloudRetailV2alphaConversationalSearchResponse", + "properties": { + "conversationId": { + "description": "Conversation UUID. This field will be stored in client side storage to maintain the conversation session with server and will be used for next search request's ConversationalSearchRequest.conversation_id to restore conversation state in server.", + "type": "string" + }, + "conversationalFilteringResult": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult", + "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search." + }, + "refinedSearch": { + "description": "The proposed refined search queries. They can be used to fetch the relevant search results. When using CONVERSATIONAL_FILTER_ONLY mode, the refined_query from search response will be populated here.", + "items": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch" + }, + "type": "array" + }, + "rephrasedQuery": { + "deprecated": true, + "description": "This field is deprecated. Please find the refinded_query from search response when using CONVERSATIONAL_FILTER_ONLY mode in ConversationalSearchResponse.refined_search instead. The rephrased query based on the user's query and the conversation history. It can be used to fetch the relevant search results.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult": { + "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search.", + "id": "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult", + "properties": { + "additionalFilter": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter", + "description": "This is the incremental additional filters implied from the current user answer. User should add the suggested addition filters to the previous ConversationalSearchRequest.search_params.filter and SearchRequest.filter, and use the merged filter in the follow up requests." + }, + "followupQuestion": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion", + "description": "The conversational filtering question." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter": { + "description": "Additional filter that client side need to apply.", + "id": "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2alphaProductAttributeValue", + "description": "Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion": { + "description": "The conversational followup question generated for Intent refinement.", + "id": "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion", + "properties": { + "followupQuestion": { + "description": "The conversational followup question generated for Intent refinement.", + "type": "string" + }, + "suggestedAnswers": { + "description": "The answer options provided to client for the follow-up question.", + "items": { + "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer": { + "description": "Suggested answers to the follow-up question.", + "id": "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2alphaProductAttributeValue", + "description": "Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch": { + "description": "The proposed refined search for intent-refinement/bundled shopping conversation. When using CONVERSATIONAL_FILTER_ONLY mode, the refined_query from search response will be populated here.", + "id": "GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch", + "properties": { + "query": { + "description": "The query to be used for search.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaCreateMerchantCenterAccountLinkMetadata": { "description": "Common metadata related to the progress of the operations.", "id": "GoogleCloudRetailV2alphaCreateMerchantCenterAccountLinkMetadata", @@ -7067,6 +7335,10 @@ "$ref": "GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec", "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set. SearchRequest.personalization_spec will override ServingConfig.personalization_spec." }, + "placeId": { + "description": "Optional. An id corresponding to a place, such as a store id or region id. When specified, we use the price from the local inventory with the matching product's LocalInventory.place_id for revenue optimization.", + "type": "string" + }, "query": { "description": "Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.", "type": "string" diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 0fa2b5d8aa..0617e4c716 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -2965,6 +2965,363 @@ func (s GoogleCloudRetailV2alphaControl) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2alphaConversationalSearchRequest: Request message for +// ConversationalSearchService.ConversationalSearch method. +type GoogleCloudRetailV2alphaConversationalSearchRequest struct { + // Branch: Required. The branch resource name, such as + // `projects/*/locations/global/catalogs/default_catalog/branches/0`. Use + // "default_branch" as the branch ID or leave this field empty, to search + // products under the default branch. + Branch string `json:"branch,omitempty"` + // ConversationId: Optional. This field specifies the conversation id, which + // maintains the state of the conversation between client side and server side. + // Use the value from the previous + // ConversationalSearchResponse.conversation_id. For the initial request, this + // should be empty. + ConversationId string `json:"conversationId,omitempty"` + // ConversationalFilteringSpec: Optional. This field specifies all + // conversational filtering related parameters. + ConversationalFilteringSpec *GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec `json:"conversationalFilteringSpec,omitempty"` + // PageCategories: Optional. The categories associated with a category page. + // Must be set for category navigation queries to achieve good search quality. + // The format should be the same as UserEvent.page_categories; To represent + // full path of category, use '>' sign to separate different hierarchies. If + // '>' is part of the category name, replace it with other character(s). + // Category pages include special pages such as sales or promotions. For + // instance, a special sale page may have the category hierarchy: + // "pageCategories" : ["Sales > 2017 Black Friday Deals"]. + PageCategories []string `json:"pageCategories,omitempty"` + // Query: Optional. Raw search query to be searched for. If this field is + // empty, the request is considered a category browsing request. + Query string `json:"query,omitempty"` + // SearchParams: Optional. Search parameters. + SearchParams *GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams `json:"searchParams,omitempty"` + // UserInfo: Optional. User information. + UserInfo *GoogleCloudRetailV2alphaUserInfo `json:"userInfo,omitempty"` + // VisitorId: Required. A unique identifier for tracking visitors. For example, + // this could be implemented with an HTTP cookie, which should be able to + // uniquely identify a visitor on a single device. This unique identifier + // should not change if the visitor logs in or out of the website. This should + // be the same identifier as UserEvent.visitor_id. The field must be a UTF-8 + // encoded string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + VisitorId string `json:"visitorId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Branch") 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. "Branch") 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 GoogleCloudRetailV2alphaConversationalSearchRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpe +// c: This field specifies all conversational filtering related parameters +// addition to conversational retail search. +type GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec struct { + // ConversationalFilteringMode: Optional. Mode to control Conversational + // Filtering. Defaults to Mode.DISABLED if it's unset. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. + // "CONVERSATIONAL_FILTER_ONLY" - Enabled Conversational Filtering without + // default Conversational Search. + ConversationalFilteringMode string `json:"conversationalFilteringMode,omitempty"` + // EnableConversationalFiltering: Optional. This field is deprecated. Please + // use ConversationalFilteringSpec.conversational_filtering_mode instead. + EnableConversationalFiltering bool `json:"enableConversationalFiltering,omitempty"` + // UserAnswer: Optional. This field specifies the current user answer during + // the conversational filtering search. It can be either user selected from + // suggested answers or user input plain text. + UserAnswer *GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer `json:"userAnswer,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "ConversationalFilteringMode") 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. "ConversationalFilteringMode") 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 GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams: Search +// parameters. +type GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams struct { + // BoostSpec: Optional. The boost spec to specify the boosting of search + // results. The syntax of the boost spec is the same as + // SearchRequest.boost_spec. + BoostSpec *GoogleCloudRetailV2alphaSearchRequestBoostSpec `json:"boostSpec,omitempty"` + // CanonicalFilter: Optional. The canonical filter string to restrict search + // results. The syntax of the canonical filter string is the same as + // SearchRequest.canonical_filter. + CanonicalFilter string `json:"canonicalFilter,omitempty"` + // Filter: Optional. The filter string to restrict search results. The syntax + // of the filter string is the same as SearchRequest.filter. + Filter string `json:"filter,omitempty"` + // SortBy: Optional. The sort string to specify the sorting of search results. + // The syntax of the sort string is the same as SearchRequest.sort. + SortBy string `json:"sortBy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoostSpec") 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. "BoostSpec") 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 GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer: This field +// specifies the current user answer during the conversational filtering +// search. This can be either user selected from suggested answers or user +// input plain text. +type GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer struct { + // SelectedAnswer: Optional. This field specifies the selected answer during + // the conversational search. This should be a subset of + // ConversationalSearchResponse.followup_question.suggested_answers. + SelectedAnswer *GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer `json:"selectedAnswer,omitempty"` + // TextAnswer: This field specifies the incremental input text from the user + // during the conversational search. + TextAnswer string `json:"textAnswer,omitempty"` + // ForceSendFields is a list of field names (e.g. "SelectedAnswer") 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. "SelectedAnswer") 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 GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer: +// This field specifies the selected answers during the conversational search. +type GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer struct { + // ProductAttributeValue: Optional. This field specifies the selected answer + // which is a attribute key-value. + ProductAttributeValue *GoogleCloudRetailV2alphaProductAttributeValue `json:"productAttributeValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProductAttributeValue") 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. "ProductAttributeValue") 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 GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchRequestUserAnswerSelectedAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchResponse: Response message for +// ConversationalSearchService.ConversationalSearch method. +type GoogleCloudRetailV2alphaConversationalSearchResponse struct { + // ConversationId: Conversation UUID. This field will be stored in client side + // storage to maintain the conversation session with server and will be used + // for next search request's ConversationalSearchRequest.conversation_id to + // restore conversation state in server. + ConversationId string `json:"conversationId,omitempty"` + // ConversationalFilteringResult: This field specifies all related information + // that is needed on client side for UI rendering of conversational filtering + // search. + ConversationalFilteringResult *GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult `json:"conversationalFilteringResult,omitempty"` + // RefinedSearch: The proposed refined search queries. They can be used to + // fetch the relevant search results. When using CONVERSATIONAL_FILTER_ONLY + // mode, the refined_query from search response will be populated here. + RefinedSearch []*GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch `json:"refinedSearch,omitempty"` + // RephrasedQuery: This field is deprecated. Please find the refinded_query + // from search response when using CONVERSATIONAL_FILTER_ONLY mode in + // ConversationalSearchResponse.refined_search instead. The rephrased query + // based on the user's query and the conversation history. It can be used to + // fetch the relevant search results. + RephrasedQuery string `json:"rephrasedQuery,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ConversationId") 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. "ConversationId") 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 GoogleCloudRetailV2alphaConversationalSearchResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringRe +// sult: This field specifies all related information that is needed on client +// side for UI rendering of conversational filtering search. +type GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult struct { + // AdditionalFilter: This is the incremental additional filters implied from + // the current user answer. User should add the suggested addition filters to + // the previous ConversationalSearchRequest.search_params.filter and + // SearchRequest.filter, and use the merged filter in the follow up requests. + AdditionalFilter *GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter `json:"additionalFilter,omitempty"` + // FollowupQuestion: The conversational filtering question. + FollowupQuestion *GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion `json:"followupQuestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalFilter") 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. "AdditionalFilter") 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 GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringRe +// sultAdditionalFilter: Additional filter that client side need to apply. +type GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter struct { + // ProductAttributeValue: Product attribute value, including an attribute key + // and an attribute value. Other types can be added here in the future. + ProductAttributeValue *GoogleCloudRetailV2alphaProductAttributeValue `json:"productAttributeValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProductAttributeValue") 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. "ProductAttributeValue") 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 GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResultAdditionalFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion: The +// conversational followup question generated for Intent refinement. +type GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion struct { + // FollowupQuestion: The conversational followup question generated for Intent + // refinement. + FollowupQuestion string `json:"followupQuestion,omitempty"` + // SuggestedAnswers: The answer options provided to client for the follow-up + // question. + SuggestedAnswers []*GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer `json:"suggestedAnswers,omitempty"` + // ForceSendFields is a list of field names (e.g. "FollowupQuestion") 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. "FollowupQuestion") 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 GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggested +// Answer: Suggested answers to the follow-up question. +type GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer struct { + // ProductAttributeValue: Product attribute value, including an attribute key + // and an attribute value. Other types can be added here in the future. + ProductAttributeValue *GoogleCloudRetailV2alphaProductAttributeValue `json:"productAttributeValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProductAttributeValue") 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. "ProductAttributeValue") 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 GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch: The +// proposed refined search for intent-refinement/bundled shopping conversation. +// When using CONVERSATIONAL_FILTER_ONLY mode, the refined_query from search +// response will be populated here. +type GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch struct { + // Query: The query to be used for search. + Query string `json:"query,omitempty"` + // ForceSendFields is a list of field names (e.g. "Query") 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. "Query") 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 GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2alphaCreateMerchantCenterAccountLinkMetadata: Common // metadata related to the progress of the operations. type GoogleCloudRetailV2alphaCreateMerchantCenterAccountLinkMetadata struct { @@ -7119,6 +7476,10 @@ type GoogleCloudRetailV2alphaSearchRequest struct { // SearchRequest.personalization_spec will override // ServingConfig.personalization_spec. PersonalizationSpec *GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` + // PlaceId: Optional. An id corresponding to a place, such as a store id or + // region id. When specified, we use the price from the local inventory with + // the matching product's LocalInventory.place_id for revenue optimization. + PlaceId string `json:"placeId,omitempty"` // Query: Raw search query. If this field is empty, the request is considered a // category browsing request and returned results are based on filter and // page_categories. @@ -10654,13 +11015,13 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Query(query string) *Projec return c } -// VisitorId sets the optional parameter "visitorId": Required field. A unique -// identifier for tracking visitors. For example, this could be implemented -// with an HTTP cookie, which should be able to uniquely identify a visitor on -// a single device. This unique identifier should not change if the visitor -// logs in or out of the website. The field must be a UTF-8 encoded string with -// a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is -// returned. +// VisitorId sets the optional parameter "visitorId": Recommended field. A +// unique identifier for tracking visitors. For example, this could be +// implemented with an HTTP cookie, which should be able to uniquely identify a +// visitor on a single device. This unique identifier should not change if the +// visitor logs in or out of the website. The field must be a UTF-8 encoded +// string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT +// error is returned. func (c *ProjectsLocationsCatalogsCompleteQueryCall) VisitorId(visitorId string) *ProjectsLocationsCatalogsCompleteQueryCall { c.urlParams_.Set("visitorId", visitorId) return c @@ -17118,6 +17479,116 @@ func (c *ProjectsLocationsCatalogsOperationsListCall) Pages(ctx context.Context, } } +type ProjectsLocationsCatalogsPlacementsConversationalSearchCall struct { + s *Service + placement string + googlecloudretailv2alphaconversationalsearchrequest *GoogleCloudRetailV2alphaConversationalSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ConversationalSearch: Performs a conversational search. This feature is only +// available for users who have Conversational Search enabled. +// +// - placement: The resource name of the search engine placement, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/default_se +// arch` or +// `projects/*/locations/global/catalogs/default_catalog/servingConfigs/defaul +// t_serving_config` This field is used to identify the serving config name +// and the set of models that will be used to make the search. +func (r *ProjectsLocationsCatalogsPlacementsService) ConversationalSearch(placement string, googlecloudretailv2alphaconversationalsearchrequest *GoogleCloudRetailV2alphaConversationalSearchRequest) *ProjectsLocationsCatalogsPlacementsConversationalSearchCall { + c := &ProjectsLocationsCatalogsPlacementsConversationalSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.placement = placement + c.googlecloudretailv2alphaconversationalsearchrequest = googlecloudretailv2alphaconversationalsearchrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCatalogsPlacementsConversationalSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsPlacementsConversationalSearchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCatalogsPlacementsConversationalSearchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsPlacementsConversationalSearchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCatalogsPlacementsConversationalSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsPlacementsConversationalSearchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudretailv2alphaconversationalsearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2alpha/{+placement}:conversationalSearch") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "placement": c.placement, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "retail.projects.locations.catalogs.placements.conversationalSearch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.placements.conversationalSearch" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRetailV2alphaConversationalSearchResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCatalogsPlacementsConversationalSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2alphaConversationalSearchResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRetailV2alphaConversationalSearchResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "retail.projects.locations.catalogs.placements.conversationalSearch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsCatalogsPlacementsPredictCall struct { s *Service placement string @@ -17477,6 +17948,116 @@ func (c *ProjectsLocationsCatalogsServingConfigsAddControlCall) Do(opts ...googl return ret, nil } +type ProjectsLocationsCatalogsServingConfigsConversationalSearchCall struct { + s *Service + placement string + googlecloudretailv2alphaconversationalsearchrequest *GoogleCloudRetailV2alphaConversationalSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ConversationalSearch: Performs a conversational search. This feature is only +// available for users who have Conversational Search enabled. +// +// - placement: The resource name of the search engine placement, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/default_se +// arch` or +// `projects/*/locations/global/catalogs/default_catalog/servingConfigs/defaul +// t_serving_config` This field is used to identify the serving config name +// and the set of models that will be used to make the search. +func (r *ProjectsLocationsCatalogsServingConfigsService) ConversationalSearch(placement string, googlecloudretailv2alphaconversationalsearchrequest *GoogleCloudRetailV2alphaConversationalSearchRequest) *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall { + c := &ProjectsLocationsCatalogsServingConfigsConversationalSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.placement = placement + c.googlecloudretailv2alphaconversationalsearchrequest = googlecloudretailv2alphaconversationalsearchrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudretailv2alphaconversationalsearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2alpha/{+placement}:conversationalSearch") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "placement": c.placement, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "retail.projects.locations.catalogs.servingConfigs.conversationalSearch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.servingConfigs.conversationalSearch" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRetailV2alphaConversationalSearchResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2alphaConversationalSearchResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRetailV2alphaConversationalSearchResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "retail.projects.locations.catalogs.servingConfigs.conversationalSearch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsCatalogsServingConfigsCreateCall struct { s *Service parent string diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 3db6b8f877..28d03e0313 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -226,7 +226,7 @@ "type": "string" }, "visitorId": { - "description": "Required field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Recommended field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "location": "query", "type": "string" } @@ -2368,7 +2368,7 @@ } } }, - "revision": "20250227", + "revision": "20250314", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -7015,6 +7015,10 @@ "$ref": "GoogleCloudRetailV2betaSearchRequestPersonalizationSpec", "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set. SearchRequest.personalization_spec will override ServingConfig.personalization_spec." }, + "placeId": { + "description": "Optional. An id corresponding to a place, such as a store id or region id. When specified, we use the price from the local inventory with the matching product's LocalInventory.place_id for revenue optimization.", + "type": "string" + }, "query": { "description": "Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.", "type": "string" diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 8e7aa2085d..65db94f341 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -7490,6 +7490,10 @@ type GoogleCloudRetailV2betaSearchRequest struct { // SearchRequest.personalization_spec will override // ServingConfig.personalization_spec. PersonalizationSpec *GoogleCloudRetailV2betaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` + // PlaceId: Optional. An id corresponding to a place, such as a store id or + // region id. When specified, we use the price from the local inventory with + // the matching product's LocalInventory.place_id for revenue optimization. + PlaceId string `json:"placeId,omitempty"` // Query: Raw search query. If this field is empty, the request is considered a // category browsing request and returned results are based on filter and // page_categories. @@ -9577,13 +9581,13 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Query(query string) *Projec return c } -// VisitorId sets the optional parameter "visitorId": Required field. A unique -// identifier for tracking visitors. For example, this could be implemented -// with an HTTP cookie, which should be able to uniquely identify a visitor on -// a single device. This unique identifier should not change if the visitor -// logs in or out of the website. The field must be a UTF-8 encoded string with -// a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is -// returned. +// VisitorId sets the optional parameter "visitorId": Recommended field. A +// unique identifier for tracking visitors. For example, this could be +// implemented with an HTTP cookie, which should be able to uniquely identify a +// visitor on a single device. This unique identifier should not change if the +// visitor logs in or out of the website. The field must be a UTF-8 encoded +// string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT +// error is returned. func (c *ProjectsLocationsCatalogsCompleteQueryCall) VisitorId(visitorId string) *ProjectsLocationsCatalogsCompleteQueryCall { c.urlParams_.Set("visitorId", visitorId) return c diff --git a/run/v1/run-api.json b/run/v1/run-api.json index 11413792b7..beaf748a95 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -86,6 +86,11 @@ "endpointUrl": "https://europe-north1-run.googleapis.com/", "location": "europe-north1" }, + { + "description": "Locational Endpoint", + "endpointUrl": "https://europe-north2-run.googleapis.com/", + "location": "europe-north2" + }, { "description": "Locational Endpoint", "endpointUrl": "https://europe-southwest1-run.googleapis.com/", @@ -2619,7 +2624,7 @@ } } }, - "revision": "20250307", + "revision": "20250309", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 06e69a2465..b1fcfa276f 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -86,6 +86,11 @@ "endpointUrl": "https://europe-north1-run.googleapis.com/", "location": "europe-north1" }, + { + "description": "Locational Endpoint", + "endpointUrl": "https://europe-north2-run.googleapis.com/", + "location": "europe-north2" + }, { "description": "Locational Endpoint", "endpointUrl": "https://europe-southwest1-run.googleapis.com/", @@ -379,7 +384,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the resource of which metadata should be exported. Format: `projects/{project_id_or_number}/locations/{location}/services/{service}` for Service `projects/{project_id_or_number}/locations/{location}/services/{service}/revisions/{revision}` for Revision `projects/{project_id_or_number}/locations/{location}/jobs/{job}/executions/{execution}` for Execution", + "description": "Required. The name of the resource of which metadata should be exported. Format: `projects/{project_id_or_number}/locations/{location}/services/{service}` for Service `projects/{project_id_or_number}/locations/{location}/services/{service}/revisions/{revision}` for Revision `projects/{project_id_or_number}/locations/{location}/jobs/{job}/executions/{execution}` for Execution {project_id_or_number} may contains domain-scoped project IDs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/.*$", "required": true, @@ -1626,37 +1631,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "getIamPolicy": { - "description": "Gets the IAM Access Control policy currently in effect for the given Cloud Run WorkerPool. This result does not include any inherited policies.", - "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools/{workerPoolsId}:getIamPolicy", - "httpMethod": "GET", - "id": "run.projects.locations.workerPools.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "options.requestedPolicyVersion": { - "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "format": "int32", - "location": "query", - "type": "integer" - }, - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/workerPools/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+resource}:getIamPolicy", - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "list": { "description": "Lists WorkerPools. Results are sorted by creation time, descending.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools", @@ -1747,34 +1721,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "setIamPolicy": { - "description": "Sets the IAM Access control policy for the specified WorkerPool. Overwrites any existing policy.", - "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools/{workerPoolsId}:setIamPolicy", - "httpMethod": "POST", - "id": "run.projects.locations.workerPools.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/workerPools/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+resource}:setIamPolicy", - "request": { - "$ref": "GoogleIamV1SetIamPolicyRequest" - }, - "response": { - "$ref": "GoogleIamV1Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified Project. There are no permissions required for making this API call.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/workerPools/{workerPoolsId}:testIamPermissions", @@ -1917,7 +1863,7 @@ } } }, - "revision": "20250228", + "revision": "20250309", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -6607,7 +6553,7 @@ "id": "UtilStatusProto", "properties": { "canonicalCode": { - "description": "The canonical error code (see codes.proto) that most closely corresponds to this status. This may be missing, and in the common case of the generic space, it definitely will be. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional int32 canonical_code = 6;", + "description": "copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional int32 canonical_code = 6;", "format": "int32", "type": "integer" }, @@ -6625,7 +6571,7 @@ "description": "message_set associates an arbitrary proto message with the status. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional proto2.bridge.MessageSet message_set = 5;" }, "space": { - "description": "The following are usually only present when code != 0 Space to which this status belongs copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional string space = 2;", + "description": "copybara:strip_begin(b/383363683) Space to which this status belongs copybara:strip_end_and_replace optional string space = 2; // Space to which this status belongs", "type": "string" } }, diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index d9544e8dec..0d79c61f61 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -5817,9 +5817,7 @@ type Proto2BridgeMessageSet struct { // UtilStatusProto: Wire-format for a Status object type UtilStatusProto struct { - // CanonicalCode: The canonical error code (see codes.proto) that most closely - // corresponds to this status. This may be missing, and in the common case of - // the generic space, it definitely will be. copybara:strip_begin(b/383363683) + // CanonicalCode: copybara:strip_begin(b/383363683) // copybara:strip_end_and_replace optional int32 canonical_code = 6; CanonicalCode int64 `json:"canonicalCode,omitempty"` // Code: Numeric code drawn from the space specified below. Often, this is the @@ -5834,9 +5832,9 @@ type UtilStatusProto struct { // status. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace // optional proto2.bridge.MessageSet message_set = 5; MessageSet *Proto2BridgeMessageSet `json:"messageSet,omitempty"` - // Space: The following are usually only present when code != 0 Space to which - // this status belongs copybara:strip_begin(b/383363683) - // copybara:strip_end_and_replace optional string space = 2; + // Space: copybara:strip_begin(b/383363683) Space to which this status belongs + // copybara:strip_end_and_replace optional string space = 2; // Space to which + // this status belongs Space string `json:"space,omitempty"` // ForceSendFields is a list of field names (e.g. "CanonicalCode") to // unconditionally include in API requests. By default, fields with empty or @@ -6098,7 +6096,8 @@ type ProjectsLocationsExportMetadataCall struct { // `projects/{project_id_or_number}/locations/{location}/services/{service}/re // visions/{revision}` for Revision // `projects/{project_id_or_number}/locations/{location}/jobs/{job}/executions -// /{execution}` for Execution. +// /{execution}` for Execution {project_id_or_number} may contains +// domain-scoped project IDs. func (r *ProjectsLocationsService) ExportMetadata(name string) *ProjectsLocationsExportMetadataCall { c := &ProjectsLocationsExportMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -10682,137 +10681,6 @@ func (c *ProjectsLocationsWorkerPoolsGetCall) Do(opts ...googleapi.CallOption) ( return ret, nil } -type ProjectsLocationsWorkerPoolsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the IAM Access Control policy currently in effect for the -// given Cloud Run WorkerPool. This result does not include any inherited -// policies. -// -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsWorkerPoolsService) GetIamPolicy(resource string) *ProjectsLocationsWorkerPoolsGetIamPolicyCall { - c := &ProjectsLocationsWorkerPoolsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsWorkerPoolsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsWorkerPoolsGetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsWorkerPoolsGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsWorkerPoolsGetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "run.projects.locations.workerPools.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "run.projects.locations.workerPools.getIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsWorkerPoolsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "run.projects.locations.workerPools.getIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type ProjectsLocationsWorkerPoolsListCall struct { s *Service parent string @@ -11111,113 +10979,6 @@ func (c *ProjectsLocationsWorkerPoolsPatchCall) Do(opts ...googleapi.CallOption) return ret, nil } -type ProjectsLocationsWorkerPoolsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the IAM Access control policy for the specified -// WorkerPool. Overwrites any existing policy. -// -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsWorkerPoolsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsWorkerPoolsSetIamPolicyCall { - c := &ProjectsLocationsWorkerPoolsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsWorkerPoolsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsWorkerPoolsSetIamPolicyCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsWorkerPoolsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsWorkerPoolsSetIamPolicyCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsWorkerPoolsSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsWorkerPoolsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "run.projects.locations.workerPools.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "run.projects.locations.workerPools.setIamPolicy" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsWorkerPoolsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleIamV1Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "run.projects.locations.workerPools.setIamPolicy", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type ProjectsLocationsWorkerPoolsTestIamPermissionsCall struct { s *Service resource string diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index c80fb197e3..fcf3ae7fd9 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -5938,7 +5938,7 @@ } } }, - "revision": "20250228", + "revision": "20250308", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -7239,6 +7239,24 @@ }, "type": "object" }, + "Cwe": { + "description": "CWE stands for Common Weakness Enumeration. Information about this weakness, as described by [CWE](https://cwe.mitre.org/).", + "id": "Cwe", + "properties": { + "id": { + "description": "The CWE identifier, e.g. CWE-94", + "type": "string" + }, + "references": { + "description": "Any reference to the details on the CWE, for example, https://cwe.mitre.org/data/definitions/94.html", + "items": { + "$ref": "Reference" + }, + "type": "array" + } + }, + "type": "object" + }, "DataAccessEvent": { "description": "Details about a data access attempt made by a principal not authorized under applicable data security policy.", "id": "DataAccessEvent", @@ -10005,6 +10023,24 @@ }, "type": "object" }, + "GoogleCloudSecuritycenterV2Cwe": { + "description": "CWE stands for Common Weakness Enumeration. Information about this weakness, as described by [CWE](https://cwe.mitre.org/).", + "id": "GoogleCloudSecuritycenterV2Cwe", + "properties": { + "id": { + "description": "The CWE identifier, e.g. CWE-94", + "type": "string" + }, + "references": { + "description": "Any reference to the details on the CWE, for example, https://cwe.mitre.org/data/definitions/94.html", + "items": { + "$ref": "GoogleCloudSecuritycenterV2Reference" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudSecuritycenterV2DataAccessEvent": { "description": "Details about a data access attempt made by a principal not authorized under applicable data security policy.", "id": "GoogleCloudSecuritycenterV2DataAccessEvent", @@ -12823,6 +12859,13 @@ "$ref": "GoogleCloudSecuritycenterV2Cve", "description": "CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)" }, + "cwes": { + "description": "Represents one or more Common Weakness Enumeration (CWE) information on this vulnerability.", + "items": { + "$ref": "GoogleCloudSecuritycenterV2Cwe" + }, + "type": "array" + }, "fixedPackage": { "$ref": "GoogleCloudSecuritycenterV2Package", "description": "The fixed package is relevant to the finding." @@ -12831,6 +12874,15 @@ "$ref": "GoogleCloudSecuritycenterV2Package", "description": "The offending package is relevant to the finding." }, + "providerRiskScore": { + "description": "Provider provided risk_score based on multiple factors. The higher the risk score, the more risky the vulnerability is.", + "format": "int64", + "type": "string" + }, + "reachable": { + "description": "Represents whether the vulnerability is reachable (detected via static analysis)", + "type": "boolean" + }, "securityBulletin": { "$ref": "GoogleCloudSecuritycenterV2SecurityBulletin", "description": "The security bulletin is relevant to this finding." @@ -15420,6 +15472,13 @@ "$ref": "Cve", "description": "CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)" }, + "cwes": { + "description": "Represents one or more Common Weakness Enumeration (CWE) information on this vulnerability.", + "items": { + "$ref": "Cwe" + }, + "type": "array" + }, "fixedPackage": { "$ref": "Package", "description": "The fixed package is relevant to the finding." @@ -15428,6 +15487,15 @@ "$ref": "Package", "description": "The offending package is relevant to the finding." }, + "providerRiskScore": { + "description": "Provider provided risk_score based on multiple factors. The higher the risk score, the more risky the vulnerability is.", + "format": "int64", + "type": "string" + }, + "reachable": { + "description": "Represents whether the vulnerability is reachable (detected via static analysis)", + "type": "boolean" + }, "securityBulletin": { "$ref": "SecurityBulletin", "description": "The security bulletin is relevant to this finding." diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 3bafee7442..fe1dc03352 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -2616,6 +2616,32 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error { return nil } +// Cwe: CWE stands for Common Weakness Enumeration. Information about this +// weakness, as described by CWE (https://cwe.mitre.org/). +type Cwe struct { + // Id: The CWE identifier, e.g. CWE-94 + Id string `json:"id,omitempty"` + // References: Any reference to the details on the CWE, for example, + // https://cwe.mitre.org/data/definitions/94.html + References []*Reference `json:"references,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // 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. "Id") 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 Cwe) MarshalJSON() ([]byte, error) { + type NoMethod Cwe + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataAccessEvent: Details about a data access attempt made by a principal not // authorized under applicable data security policy. type DataAccessEvent struct { @@ -5939,6 +5965,33 @@ func (s *GoogleCloudSecuritycenterV2Cvssv3) UnmarshalJSON(data []byte) error { return nil } +// GoogleCloudSecuritycenterV2Cwe: CWE stands for Common Weakness Enumeration. +// Information about this weakness, as described by CWE +// (https://cwe.mitre.org/). +type GoogleCloudSecuritycenterV2Cwe struct { + // Id: The CWE identifier, e.g. CWE-94 + Id string `json:"id,omitempty"` + // References: Any reference to the details on the CWE, for example, + // https://cwe.mitre.org/data/definitions/94.html + References []*GoogleCloudSecuritycenterV2Reference `json:"references,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // 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. "Id") 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 GoogleCloudSecuritycenterV2Cwe) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSecuritycenterV2Cwe + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSecuritycenterV2DataAccessEvent: Details about a data access // attempt made by a principal not authorized under applicable data security // policy. @@ -9054,10 +9107,19 @@ type GoogleCloudSecuritycenterV2Vulnerability struct { // Cve: CVE stands for Common Vulnerabilities and Exposures // (https://cve.mitre.org/about/) Cve *GoogleCloudSecuritycenterV2Cve `json:"cve,omitempty"` + // Cwes: Represents one or more Common Weakness Enumeration (CWE) information + // on this vulnerability. + Cwes []*GoogleCloudSecuritycenterV2Cwe `json:"cwes,omitempty"` // FixedPackage: The fixed package is relevant to the finding. FixedPackage *GoogleCloudSecuritycenterV2Package `json:"fixedPackage,omitempty"` // OffendingPackage: The offending package is relevant to the finding. OffendingPackage *GoogleCloudSecuritycenterV2Package `json:"offendingPackage,omitempty"` + // ProviderRiskScore: Provider provided risk_score based on multiple factors. + // The higher the risk score, the more risky the vulnerability is. + ProviderRiskScore int64 `json:"providerRiskScore,omitempty,string"` + // Reachable: Represents whether the vulnerability is reachable (detected via + // static analysis) + Reachable bool `json:"reachable,omitempty"` // SecurityBulletin: The security bulletin is relevant to this finding. SecurityBulletin *GoogleCloudSecuritycenterV2SecurityBulletin `json:"securityBulletin,omitempty"` // ForceSendFields is a list of field names (e.g. "Cve") to unconditionally @@ -12399,10 +12461,19 @@ type Vulnerability struct { // Cve: CVE stands for Common Vulnerabilities and Exposures // (https://cve.mitre.org/about/) Cve *Cve `json:"cve,omitempty"` + // Cwes: Represents one or more Common Weakness Enumeration (CWE) information + // on this vulnerability. + Cwes []*Cwe `json:"cwes,omitempty"` // FixedPackage: The fixed package is relevant to the finding. FixedPackage *Package `json:"fixedPackage,omitempty"` // OffendingPackage: The offending package is relevant to the finding. OffendingPackage *Package `json:"offendingPackage,omitempty"` + // ProviderRiskScore: Provider provided risk_score based on multiple factors. + // The higher the risk score, the more risky the vulnerability is. + ProviderRiskScore int64 `json:"providerRiskScore,omitempty,string"` + // Reachable: Represents whether the vulnerability is reachable (detected via + // static analysis) + Reachable bool `json:"reachable,omitempty"` // SecurityBulletin: The security bulletin is relevant to this finding. SecurityBulletin *SecurityBulletin `json:"securityBulletin,omitempty"` // ForceSendFields is a list of field names (e.g. "Cve") to unconditionally diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index 2408b9688c..00d1728233 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -913,7 +913,7 @@ } } }, - "revision": "20250228", + "revision": "20250308", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1975,6 +1975,24 @@ }, "type": "object" }, + "Cwe": { + "description": "CWE stands for Common Weakness Enumeration. Information about this weakness, as described by [CWE](https://cwe.mitre.org/).", + "id": "Cwe", + "properties": { + "id": { + "description": "The CWE identifier, e.g. CWE-94", + "type": "string" + }, + "references": { + "description": "Any reference to the details on the CWE, for example, https://cwe.mitre.org/data/definitions/94.html", + "items": { + "$ref": "Reference" + }, + "type": "array" + } + }, + "type": "object" + }, "DataAccessEvent": { "description": "Details about a data access attempt made by a principal not authorized under applicable data security policy.", "id": "DataAccessEvent", @@ -4676,6 +4694,24 @@ }, "type": "object" }, + "GoogleCloudSecuritycenterV2Cwe": { + "description": "CWE stands for Common Weakness Enumeration. Information about this weakness, as described by [CWE](https://cwe.mitre.org/).", + "id": "GoogleCloudSecuritycenterV2Cwe", + "properties": { + "id": { + "description": "The CWE identifier, e.g. CWE-94", + "type": "string" + }, + "references": { + "description": "Any reference to the details on the CWE, for example, https://cwe.mitre.org/data/definitions/94.html", + "items": { + "$ref": "GoogleCloudSecuritycenterV2Reference" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudSecuritycenterV2DataAccessEvent": { "description": "Details about a data access attempt made by a principal not authorized under applicable data security policy.", "id": "GoogleCloudSecuritycenterV2DataAccessEvent", @@ -7494,6 +7530,13 @@ "$ref": "GoogleCloudSecuritycenterV2Cve", "description": "CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)" }, + "cwes": { + "description": "Represents one or more Common Weakness Enumeration (CWE) information on this vulnerability.", + "items": { + "$ref": "GoogleCloudSecuritycenterV2Cwe" + }, + "type": "array" + }, "fixedPackage": { "$ref": "GoogleCloudSecuritycenterV2Package", "description": "The fixed package is relevant to the finding." @@ -7502,6 +7545,15 @@ "$ref": "GoogleCloudSecuritycenterV2Package", "description": "The offending package is relevant to the finding." }, + "providerRiskScore": { + "description": "Provider provided risk_score based on multiple factors. The higher the risk score, the more risky the vulnerability is.", + "format": "int64", + "type": "string" + }, + "reachable": { + "description": "Represents whether the vulnerability is reachable (detected via static analysis)", + "type": "boolean" + }, "securityBulletin": { "$ref": "GoogleCloudSecuritycenterV2SecurityBulletin", "description": "The security bulletin is relevant to this finding." @@ -9408,6 +9460,13 @@ "$ref": "Cve", "description": "CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)" }, + "cwes": { + "description": "Represents one or more Common Weakness Enumeration (CWE) information on this vulnerability.", + "items": { + "$ref": "Cwe" + }, + "type": "array" + }, "fixedPackage": { "$ref": "Package", "description": "The fixed package is relevant to the finding." @@ -9416,6 +9475,15 @@ "$ref": "Package", "description": "The offending package is relevant to the finding." }, + "providerRiskScore": { + "description": "Provider provided risk_score based on multiple factors. The higher the risk score, the more risky the vulnerability is.", + "format": "int64", + "type": "string" + }, + "reachable": { + "description": "Represents whether the vulnerability is reachable (detected via static analysis)", + "type": "boolean" + }, "securityBulletin": { "$ref": "SecurityBulletin", "description": "The security bulletin is relevant to this finding." diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 6a07507a50..b997b4b5d8 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -1617,6 +1617,32 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error { return nil } +// Cwe: CWE stands for Common Weakness Enumeration. Information about this +// weakness, as described by CWE (https://cwe.mitre.org/). +type Cwe struct { + // Id: The CWE identifier, e.g. CWE-94 + Id string `json:"id,omitempty"` + // References: Any reference to the details on the CWE, for example, + // https://cwe.mitre.org/data/definitions/94.html + References []*Reference `json:"references,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // 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. "Id") 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 Cwe) MarshalJSON() ([]byte, error) { + type NoMethod Cwe + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataAccessEvent: Details about a data access attempt made by a principal not // authorized under applicable data security policy. type DataAccessEvent struct { @@ -4901,6 +4927,33 @@ func (s *GoogleCloudSecuritycenterV2Cvssv3) UnmarshalJSON(data []byte) error { return nil } +// GoogleCloudSecuritycenterV2Cwe: CWE stands for Common Weakness Enumeration. +// Information about this weakness, as described by CWE +// (https://cwe.mitre.org/). +type GoogleCloudSecuritycenterV2Cwe struct { + // Id: The CWE identifier, e.g. CWE-94 + Id string `json:"id,omitempty"` + // References: Any reference to the details on the CWE, for example, + // https://cwe.mitre.org/data/definitions/94.html + References []*GoogleCloudSecuritycenterV2Reference `json:"references,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // 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. "Id") 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 GoogleCloudSecuritycenterV2Cwe) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSecuritycenterV2Cwe + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSecuritycenterV2DataAccessEvent: Details about a data access // attempt made by a principal not authorized under applicable data security // policy. @@ -8016,10 +8069,19 @@ type GoogleCloudSecuritycenterV2Vulnerability struct { // Cve: CVE stands for Common Vulnerabilities and Exposures // (https://cve.mitre.org/about/) Cve *GoogleCloudSecuritycenterV2Cve `json:"cve,omitempty"` + // Cwes: Represents one or more Common Weakness Enumeration (CWE) information + // on this vulnerability. + Cwes []*GoogleCloudSecuritycenterV2Cwe `json:"cwes,omitempty"` // FixedPackage: The fixed package is relevant to the finding. FixedPackage *GoogleCloudSecuritycenterV2Package `json:"fixedPackage,omitempty"` // OffendingPackage: The offending package is relevant to the finding. OffendingPackage *GoogleCloudSecuritycenterV2Package `json:"offendingPackage,omitempty"` + // ProviderRiskScore: Provider provided risk_score based on multiple factors. + // The higher the risk score, the more risky the vulnerability is. + ProviderRiskScore int64 `json:"providerRiskScore,omitempty,string"` + // Reachable: Represents whether the vulnerability is reachable (detected via + // static analysis) + Reachable bool `json:"reachable,omitempty"` // SecurityBulletin: The security bulletin is relevant to this finding. SecurityBulletin *GoogleCloudSecuritycenterV2SecurityBulletin `json:"securityBulletin,omitempty"` // ForceSendFields is a list of field names (e.g. "Cve") to unconditionally @@ -10323,10 +10385,19 @@ type Vulnerability struct { // Cve: CVE stands for Common Vulnerabilities and Exposures // (https://cve.mitre.org/about/) Cve *Cve `json:"cve,omitempty"` + // Cwes: Represents one or more Common Weakness Enumeration (CWE) information + // on this vulnerability. + Cwes []*Cwe `json:"cwes,omitempty"` // FixedPackage: The fixed package is relevant to the finding. FixedPackage *Package `json:"fixedPackage,omitempty"` // OffendingPackage: The offending package is relevant to the finding. OffendingPackage *Package `json:"offendingPackage,omitempty"` + // ProviderRiskScore: Provider provided risk_score based on multiple factors. + // The higher the risk score, the more risky the vulnerability is. + ProviderRiskScore int64 `json:"providerRiskScore,omitempty,string"` + // Reachable: Represents whether the vulnerability is reachable (detected via + // static analysis) + Reachable bool `json:"reachable,omitempty"` // SecurityBulletin: The security bulletin is relevant to this finding. SecurityBulletin *SecurityBulletin `json:"securityBulletin,omitempty"` // ForceSendFields is a list of field names (e.g. "Cve") to unconditionally diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index f5df777bfa..4cae99f1b0 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -2003,7 +2003,7 @@ } } }, - "revision": "20250228", + "revision": "20250308", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3001,6 +3001,24 @@ }, "type": "object" }, + "Cwe": { + "description": "CWE stands for Common Weakness Enumeration. Information about this weakness, as described by [CWE](https://cwe.mitre.org/).", + "id": "Cwe", + "properties": { + "id": { + "description": "The CWE identifier, e.g. CWE-94", + "type": "string" + }, + "references": { + "description": "Any reference to the details on the CWE, for example, https://cwe.mitre.org/data/definitions/94.html", + "items": { + "$ref": "Reference" + }, + "type": "array" + } + }, + "type": "object" + }, "DataAccessEvent": { "description": "Details about a data access attempt made by a principal not authorized under applicable data security policy.", "id": "DataAccessEvent", @@ -5669,6 +5687,24 @@ }, "type": "object" }, + "GoogleCloudSecuritycenterV2Cwe": { + "description": "CWE stands for Common Weakness Enumeration. Information about this weakness, as described by [CWE](https://cwe.mitre.org/).", + "id": "GoogleCloudSecuritycenterV2Cwe", + "properties": { + "id": { + "description": "The CWE identifier, e.g. CWE-94", + "type": "string" + }, + "references": { + "description": "Any reference to the details on the CWE, for example, https://cwe.mitre.org/data/definitions/94.html", + "items": { + "$ref": "GoogleCloudSecuritycenterV2Reference" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudSecuritycenterV2DataAccessEvent": { "description": "Details about a data access attempt made by a principal not authorized under applicable data security policy.", "id": "GoogleCloudSecuritycenterV2DataAccessEvent", @@ -8487,6 +8523,13 @@ "$ref": "GoogleCloudSecuritycenterV2Cve", "description": "CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)" }, + "cwes": { + "description": "Represents one or more Common Weakness Enumeration (CWE) information on this vulnerability.", + "items": { + "$ref": "GoogleCloudSecuritycenterV2Cwe" + }, + "type": "array" + }, "fixedPackage": { "$ref": "GoogleCloudSecuritycenterV2Package", "description": "The fixed package is relevant to the finding." @@ -8495,6 +8538,15 @@ "$ref": "GoogleCloudSecuritycenterV2Package", "description": "The offending package is relevant to the finding." }, + "providerRiskScore": { + "description": "Provider provided risk_score based on multiple factors. The higher the risk score, the more risky the vulnerability is.", + "format": "int64", + "type": "string" + }, + "reachable": { + "description": "Represents whether the vulnerability is reachable (detected via static analysis)", + "type": "boolean" + }, "securityBulletin": { "$ref": "GoogleCloudSecuritycenterV2SecurityBulletin", "description": "The security bulletin is relevant to this finding." @@ -10104,6 +10156,13 @@ "$ref": "Cve", "description": "CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)" }, + "cwes": { + "description": "Represents one or more Common Weakness Enumeration (CWE) information on this vulnerability.", + "items": { + "$ref": "Cwe" + }, + "type": "array" + }, "fixedPackage": { "$ref": "Package", "description": "The fixed package is relevant to the finding." @@ -10112,6 +10171,15 @@ "$ref": "Package", "description": "The offending package is relevant to the finding." }, + "providerRiskScore": { + "description": "Provider provided risk_score based on multiple factors. The higher the risk score, the more risky the vulnerability is.", + "format": "int64", + "type": "string" + }, + "reachable": { + "description": "Represents whether the vulnerability is reachable (detected via static analysis)", + "type": "boolean" + }, "securityBulletin": { "$ref": "SecurityBulletin", "description": "The security bulletin is relevant to this finding." diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index e0cf696fea..5bbfe4da01 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -1671,6 +1671,32 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error { return nil } +// Cwe: CWE stands for Common Weakness Enumeration. Information about this +// weakness, as described by CWE (https://cwe.mitre.org/). +type Cwe struct { + // Id: The CWE identifier, e.g. CWE-94 + Id string `json:"id,omitempty"` + // References: Any reference to the details on the CWE, for example, + // https://cwe.mitre.org/data/definitions/94.html + References []*Reference `json:"references,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // 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. "Id") 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 Cwe) MarshalJSON() ([]byte, error) { + type NoMethod Cwe + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataAccessEvent: Details about a data access attempt made by a principal not // authorized under applicable data security policy. type DataAccessEvent struct { @@ -4852,6 +4878,33 @@ func (s *GoogleCloudSecuritycenterV2Cvssv3) UnmarshalJSON(data []byte) error { return nil } +// GoogleCloudSecuritycenterV2Cwe: CWE stands for Common Weakness Enumeration. +// Information about this weakness, as described by CWE +// (https://cwe.mitre.org/). +type GoogleCloudSecuritycenterV2Cwe struct { + // Id: The CWE identifier, e.g. CWE-94 + Id string `json:"id,omitempty"` + // References: Any reference to the details on the CWE, for example, + // https://cwe.mitre.org/data/definitions/94.html + References []*GoogleCloudSecuritycenterV2Reference `json:"references,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // 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. "Id") 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 GoogleCloudSecuritycenterV2Cwe) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSecuritycenterV2Cwe + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSecuritycenterV2DataAccessEvent: Details about a data access // attempt made by a principal not authorized under applicable data security // policy. @@ -7967,10 +8020,19 @@ type GoogleCloudSecuritycenterV2Vulnerability struct { // Cve: CVE stands for Common Vulnerabilities and Exposures // (https://cve.mitre.org/about/) Cve *GoogleCloudSecuritycenterV2Cve `json:"cve,omitempty"` + // Cwes: Represents one or more Common Weakness Enumeration (CWE) information + // on this vulnerability. + Cwes []*GoogleCloudSecuritycenterV2Cwe `json:"cwes,omitempty"` // FixedPackage: The fixed package is relevant to the finding. FixedPackage *GoogleCloudSecuritycenterV2Package `json:"fixedPackage,omitempty"` // OffendingPackage: The offending package is relevant to the finding. OffendingPackage *GoogleCloudSecuritycenterV2Package `json:"offendingPackage,omitempty"` + // ProviderRiskScore: Provider provided risk_score based on multiple factors. + // The higher the risk score, the more risky the vulnerability is. + ProviderRiskScore int64 `json:"providerRiskScore,omitempty,string"` + // Reachable: Represents whether the vulnerability is reachable (detected via + // static analysis) + Reachable bool `json:"reachable,omitempty"` // SecurityBulletin: The security bulletin is relevant to this finding. SecurityBulletin *GoogleCloudSecuritycenterV2SecurityBulletin `json:"securityBulletin,omitempty"` // ForceSendFields is a list of field names (e.g. "Cve") to unconditionally @@ -9728,10 +9790,19 @@ type Vulnerability struct { // Cve: CVE stands for Common Vulnerabilities and Exposures // (https://cve.mitre.org/about/) Cve *Cve `json:"cve,omitempty"` + // Cwes: Represents one or more Common Weakness Enumeration (CWE) information + // on this vulnerability. + Cwes []*Cwe `json:"cwes,omitempty"` // FixedPackage: The fixed package is relevant to the finding. FixedPackage *Package `json:"fixedPackage,omitempty"` // OffendingPackage: The offending package is relevant to the finding. OffendingPackage *Package `json:"offendingPackage,omitempty"` + // ProviderRiskScore: Provider provided risk_score based on multiple factors. + // The higher the risk score, the more risky the vulnerability is. + ProviderRiskScore int64 `json:"providerRiskScore,omitempty,string"` + // Reachable: Represents whether the vulnerability is reachable (detected via + // static analysis) + Reachable bool `json:"reachable,omitempty"` // SecurityBulletin: The security bulletin is relevant to this finding. SecurityBulletin *SecurityBulletin `json:"securityBulletin,omitempty"` // ForceSendFields is a list of field names (e.g. "Cve") to unconditionally diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json index 0d0e5b121b..2f7155c57e 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20250227", + "revision": "20250313", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -1610,7 +1610,7 @@ "description": "Some settings." }, "libraryPackage": { - "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1", + "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1", "type": "string" }, "serviceClassNames": { diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index e3d132dd50..c742780b99 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -1819,8 +1819,8 @@ type JavaSettings struct { // option set in the protobuf. This should be used **only** by APIs who have // already set the language_settings.java.package_name" field in gapic.yaml. // API teams should use the protobuf java_package option where possible. - // Example of a YAML configuration:: publishing: java_settings: - // library_package: com.google.cloud.pubsub.v1 + // Example of a YAML configuration:: publishing: library_settings: + // java_settings: library_package: com.google.cloud.pubsub.v1 LibraryPackage string `json:"libraryPackage,omitempty"` // ServiceClassNames: Configure the Java class name to use instead of the // service's for its corresponding generated GAPIC client. Keys are diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index 91797254d2..552e42307a 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -715,7 +715,7 @@ } } }, - "revision": "20250227", + "revision": "20250313", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -1695,7 +1695,7 @@ "description": "Some settings." }, "libraryPackage": { - "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1", + "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1", "type": "string" }, "serviceClassNames": { diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index a93569eba2..500e79f0e0 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -1688,8 +1688,8 @@ type JavaSettings struct { // option set in the protobuf. This should be used **only** by APIs who have // already set the language_settings.java.package_name" field in gapic.yaml. // API teams should use the protobuf java_package option where possible. - // Example of a YAML configuration:: publishing: java_settings: - // library_package: com.google.cloud.pubsub.v1 + // Example of a YAML configuration:: publishing: library_settings: + // java_settings: library_package: com.google.cloud.pubsub.v1 LibraryPackage string `json:"libraryPackage,omitempty"` // ServiceClassNames: Configure the Java class name to use instead of the // service's for its corresponding generated GAPIC client. Keys are diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json index 647304d93c..1ff5ea18f8 100644 --- a/servicenetworking/v1/servicenetworking-api.json +++ b/servicenetworking/v1/servicenetworking-api.json @@ -1029,7 +1029,7 @@ } } }, - "revision": "20250302", + "revision": "20250316", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1148,7 +1148,7 @@ "type": "boolean" }, "computeIdempotencyWindow": { - "description": "Optional. Specifies a custom time bucket for Arcus subnetwork request idempotency. If two equivalent concurrent requests are made, Arcus will know to ignore the request if it has already been completed or is in progress. Only requests with matching compute_idempotency_window have guaranteed idempotency. Changing this time window between requests results in undefined behavior. Zero (or empty) value with custom_compute_idempotency_window=true specifies no idempotency (i.e. no request ID is provided to Arcus). Maximum value of 14 days (enforced by Arcus limit). For more information on how to use, see: go/revisit-sn-idempotency-window", + "description": "Optional. Specifies a custom time bucket for GCE subnetwork request idempotency. If two equivalent concurrent requests are made, GCE will know to ignore the request if it has already been completed or is in progress. Only requests with matching compute_idempotency_window have guaranteed idempotency. Changing this time window between requests results in undefined behavior. Zero (or empty) value with custom_compute_idempotency_window=true specifies no idempotency (i.e. no request ID is provided to GCE). Maximum value of 14 days (enforced by GCE limit).", "format": "google-duration", "type": "string" }, @@ -1227,7 +1227,7 @@ "type": "array" }, "useCustomComputeIdempotencyWindow": { - "description": "Optional. Specifies if Service Networking should use a custom time bucket for Arcus idempotency. If false, Service Networking uses a 300 second (5 minute) Arcus idempotency window. If true, Service Networking uses a custom idempotency window provided by the user in field compute_idempotency_window. For more information on how to use, see: go/revisit-sn-idempotency-window", + "description": "Optional. Specifies if Service Networking should use a custom time bucket for GCE idempotency. If false, Service Networking uses a 300 second (5 minute) GCE idempotency window. If true, Service Networking uses a custom idempotency window provided by the user in field compute_idempotency_window.", "type": "boolean" } }, @@ -2540,7 +2540,7 @@ "description": "Some settings." }, "libraryPackage": { - "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1", + "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1", "type": "string" }, "serviceClassNames": { diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index 58a0981818..73dac552fe 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -467,16 +467,15 @@ type AddSubnetworkRequest struct { // determines whether the consumer project has 'servicenetworking.services.use' // permission or not. CheckServiceNetworkingUsePermission bool `json:"checkServiceNetworkingUsePermission,omitempty"` - // ComputeIdempotencyWindow: Optional. Specifies a custom time bucket for Arcus + // ComputeIdempotencyWindow: Optional. Specifies a custom time bucket for GCE // subnetwork request idempotency. If two equivalent concurrent requests are - // made, Arcus will know to ignore the request if it has already been completed + // made, GCE will know to ignore the request if it has already been completed // or is in progress. Only requests with matching compute_idempotency_window // have guaranteed idempotency. Changing this time window between requests // results in undefined behavior. Zero (or empty) value with // custom_compute_idempotency_window=true specifies no idempotency (i.e. no - // request ID is provided to Arcus). Maximum value of 14 days (enforced by - // Arcus limit). For more information on how to use, see: - // go/revisit-sn-idempotency-window + // request ID is provided to GCE). Maximum value of 14 days (enforced by GCE + // limit). ComputeIdempotencyWindow string `json:"computeIdempotencyWindow,omitempty"` // Consumer: Required. A resource that represents the service consumer, such as // `projects/123456`. The project number can be different from the value in the @@ -563,11 +562,10 @@ type AddSubnetworkRequest struct { // `roles/servicenetworking.subnetworkAdmin` role on the subnet. SubnetworkUsers []string `json:"subnetworkUsers,omitempty"` // UseCustomComputeIdempotencyWindow: Optional. Specifies if Service Networking - // should use a custom time bucket for Arcus idempotency. If false, Service - // Networking uses a 300 second (5 minute) Arcus idempotency window. If true, + // should use a custom time bucket for GCE idempotency. If false, Service + // Networking uses a 300 second (5 minute) GCE idempotency window. If true, // Service Networking uses a custom idempotency window provided by the user in - // field compute_idempotency_window. For more information on how to use, see: - // go/revisit-sn-idempotency-window + // field compute_idempotency_window. UseCustomComputeIdempotencyWindow bool `json:"useCustomComputeIdempotencyWindow,omitempty"` // ForceSendFields is a list of field names (e.g. // "AllowSubnetCidrRoutesOverlap") to unconditionally include in API requests. @@ -2524,8 +2522,8 @@ type JavaSettings struct { // option set in the protobuf. This should be used **only** by APIs who have // already set the language_settings.java.package_name" field in gapic.yaml. // API teams should use the protobuf java_package option where possible. - // Example of a YAML configuration:: publishing: java_settings: - // library_package: com.google.cloud.pubsub.v1 + // Example of a YAML configuration:: publishing: library_settings: + // java_settings: library_package: com.google.cloud.pubsub.v1 LibraryPackage string `json:"libraryPackage,omitempty"` // ServiceClassNames: Configure the Java class name to use instead of the // service's for its corresponding generated GAPIC client. Keys are diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json index 096d4304c1..4d5fc75c73 100644 --- a/servicenetworking/v1beta/servicenetworking-api.json +++ b/servicenetworking/v1beta/servicenetworking-api.json @@ -307,7 +307,7 @@ } } }, - "revision": "20250302", + "revision": "20250312", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1620,7 +1620,7 @@ "description": "Some settings." }, "libraryPackage": { - "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1", + "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1", "type": "string" }, "serviceClassNames": { diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 828079445c..b96915176c 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -2083,8 +2083,8 @@ type JavaSettings struct { // option set in the protobuf. This should be used **only** by APIs who have // already set the language_settings.java.package_name" field in gapic.yaml. // API teams should use the protobuf java_package option where possible. - // Example of a YAML configuration:: publishing: java_settings: - // library_package: com.google.cloud.pubsub.v1 + // Example of a YAML configuration:: publishing: library_settings: + // java_settings: library_package: com.google.cloud.pubsub.v1 LibraryPackage string `json:"libraryPackage,omitempty"` // ServiceClassNames: Configure the Java class name to use instead of the // service's for its corresponding generated GAPIC client. Keys are diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index 9b63dc3997..aa69153ac8 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20250227", + "revision": "20250313", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -2428,7 +2428,7 @@ "description": "Some settings." }, "libraryPackage": { - "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1", + "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1", "type": "string" }, "serviceClassNames": { diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 8219cb6f6a..5aa6445325 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -2917,8 +2917,8 @@ type JavaSettings struct { // option set in the protobuf. This should be used **only** by APIs who have // already set the language_settings.java.package_name" field in gapic.yaml. // API teams should use the protobuf java_package option where possible. - // Example of a YAML configuration:: publishing: java_settings: - // library_package: com.google.cloud.pubsub.v1 + // Example of a YAML configuration:: publishing: library_settings: + // java_settings: library_package: com.google.cloud.pubsub.v1 LibraryPackage string `json:"libraryPackage,omitempty"` // ServiceClassNames: Configure the Java class name to use instead of the // service's for its corresponding generated GAPIC client. Keys are diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index e067b495ae..193876a944 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20250227", + "revision": "20250313", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -3069,7 +3069,7 @@ "description": "Some settings." }, "libraryPackage": { - "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1", + "description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1", "type": "string" }, "serviceClassNames": { diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 22d3e56364..344d82e8f1 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -3081,8 +3081,8 @@ type JavaSettings struct { // option set in the protobuf. This should be used **only** by APIs who have // already set the language_settings.java.package_name" field in gapic.yaml. // API teams should use the protobuf java_package option where possible. - // Example of a YAML configuration:: publishing: java_settings: - // library_package: com.google.cloud.pubsub.v1 + // Example of a YAML configuration:: publishing: library_settings: + // java_settings: library_package: com.google.cloud.pubsub.v1 LibraryPackage string `json:"libraryPackage,omitempty"` // ServiceClassNames: Configure the Java class name to use instead of the // service's for its corresponding generated GAPIC client. Keys are diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index cc090370f1..2edd108e4c 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -2431,7 +2431,7 @@ ] }, "batchWrite": { - "description": "Batches the supplied mutation groups in a collection of efficient transactions. All mutations in a group are committed atomically. However, mutations across groups can be committed non-atomically in an unspecified order and thus, they must be independent of each other. Partial failure is possible, i.e., some groups may have been committed successfully, while some may have failed. The results of individual batches are streamed into the response as the batches are applied. BatchWrite requests are not replay protected, meaning that each mutation group may be applied more than once. Replays of non-idempotent mutations may have undesirable effects. For example, replays of an insert mutation may produce an already exists error or if you use generated or commit timestamp-based keys, it may result in additional rows being added to the mutation's table. We recommend structuring your mutation groups to be idempotent to avoid this issue.", + "description": "Batches the supplied mutation groups in a collection of efficient transactions. All mutations in a group are committed atomically. However, mutations across groups can be committed non-atomically in an unspecified order and thus, they must be independent of each other. Partial failure is possible, that is, some groups might have been committed successfully, while some might have failed. The results of individual batches are streamed into the response as the batches are applied. `BatchWrite` requests are not replay protected, meaning that each mutation group can be applied more than once. Replays of non-idempotent mutations can have undesirable effects. For example, replays of an insert mutation can produce an already exists error or if you use generated or commit timestamp-based keys, it can result in additional rows being added to the mutation's table. We recommend structuring your mutation groups to be idempotent to avoid this issue.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:batchWrite", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.batchWrite", @@ -2489,7 +2489,7 @@ ] }, "commit": { - "description": "Commits a transaction. The request includes the mutations to be applied to rows in the database. `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is conflicts with concurrent transactions. However, it can also happen for a variety of other reasons. If `Commit` returns `ABORTED`, the caller should re-attempt the transaction from the beginning, re-using the same session. On very rare occasions, `Commit` might return `UNKNOWN`. This can happen, for example, if the client job experiences a 1+ hour networking failure. At that point, Cloud Spanner has lost track of the transaction outcome and we recommend that you perform another read from the database to see the state of things as they are now.", + "description": "Commits a transaction. The request includes the mutations to be applied to rows in the database. `Commit` might return an `ABORTED` error. This can occur at any time; commonly, the cause is conflicts with concurrent transactions. However, it can also happen for a variety of other reasons. If `Commit` returns `ABORTED`, the caller should retry the transaction from the beginning, reusing the same session. On very rare occasions, `Commit` might return `UNKNOWN`. This can happen, for example, if the client job experiences a 1+ hour networking failure. At that point, Cloud Spanner has lost track of the transaction outcome and we recommend that you perform another read from the database to see the state of things as they are now.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:commit", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.commit", @@ -2518,7 +2518,7 @@ ] }, "create": { - "description": "Creates a new session. A session can be used to perform transactions that read and/or modify data in a Cloud Spanner database. Sessions are meant to be reused for many consecutive transactions. Sessions can only execute one transaction at a time. To execute multiple concurrent read-write/write-only transactions, create multiple sessions. Note that standalone reads and queries use a transaction internally, and count toward the one transaction limit. Active sessions use additional server resources, so it is a good idea to delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no operations are sent for more than an hour. If a session is deleted, requests to it return `NOT_FOUND`. Idle sessions can be kept alive by sending a trivial SQL query periodically, e.g., `\"SELECT 1\"`.", + "description": "Creates a new session. A session can be used to perform transactions that read and/or modify data in a Cloud Spanner database. Sessions are meant to be reused for many consecutive transactions. Sessions can only execute one transaction at a time. To execute multiple concurrent read-write/write-only transactions, create multiple sessions. Note that standalone reads and queries use a transaction internally, and count toward the one transaction limit. Active sessions use additional server resources, so it's a good idea to delete idle and unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions when no operations are sent for more than an hour. If a session is deleted, requests to it return `NOT_FOUND`. Idle sessions can be kept alive by sending a trivial SQL query periodically, for example, `\"SELECT 1\"`.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.create", @@ -2547,7 +2547,7 @@ ] }, "delete": { - "description": "Ends a session, releasing server resources associated with it. This will asynchronously trigger cancellation of any operations that are running with this session.", + "description": "Ends a session, releasing server resources associated with it. This asynchronously triggers the cancellation of any operations that are running with this session.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}", "httpMethod": "DELETE", "id": "spanner.projects.instances.databases.sessions.delete", @@ -2602,7 +2602,7 @@ ] }, "executeSql": { - "description": "Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).", + "description": "Executes an SQL statement, returning all results in a single reply. This method can't be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:executeSql", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.executeSql", @@ -2660,7 +2660,7 @@ ] }, "get": { - "description": "Gets a session. Returns `NOT_FOUND` if the session does not exist. This is mainly useful for determining whether a session is still alive.", + "description": "Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This is mainly useful for determining whether a session is still alive.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}", "httpMethod": "GET", "id": "spanner.projects.instances.databases.sessions.get", @@ -2728,7 +2728,7 @@ ] }, "partitionQuery": { - "description": "Creates a set of partition tokens that can be used to execute a query operation in parallel. Each of the returned partition tokens can be used by ExecuteStreamingSql to specify a subset of the query result to read. The same session and read-only transaction must be used by the PartitionQueryRequest used to create the partition tokens and the ExecuteSqlRequests that use the partition tokens. Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too old. When any of these happen, it is not possible to resume the query, and the whole operation must be restarted from the beginning.", + "description": "Creates a set of partition tokens that can be used to execute a query operation in parallel. Each of the returned partition tokens can be used by ExecuteStreamingSql to specify a subset of the query result to read. The same session and read-only transaction must be used by the `PartitionQueryRequest` used to create the partition tokens and the `ExecuteSqlRequests` that use the partition tokens. Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too old. When any of these happen, it isn't possible to resume the query, and the whole operation must be restarted from the beginning.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:partitionQuery", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.partitionQuery", @@ -2757,7 +2757,7 @@ ] }, "partitionRead": { - "description": "Creates a set of partition tokens that can be used to execute a read operation in parallel. Each of the returned partition tokens can be used by StreamingRead to specify a subset of the read result to read. The same session and read-only transaction must be used by the PartitionReadRequest used to create the partition tokens and the ReadRequests that use the partition tokens. There are no ordering guarantees on rows returned among the returned partition tokens, or even within each individual StreamingRead call issued with a partition_token. Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too old. When any of these happen, it is not possible to resume the read, and the whole operation must be restarted from the beginning.", + "description": "Creates a set of partition tokens that can be used to execute a read operation in parallel. Each of the returned partition tokens can be used by StreamingRead to specify a subset of the read result to read. The same session and read-only transaction must be used by the `PartitionReadRequest` used to create the partition tokens and the `ReadRequests` that use the partition tokens. There are no ordering guarantees on rows returned among the returned partition tokens, or even within each individual `StreamingRead` call issued with a `partition_token`. Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too old. When any of these happen, it isn't possible to resume the read, and the whole operation must be restarted from the beginning.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:partitionRead", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.partitionRead", @@ -2786,7 +2786,7 @@ ] }, "read": { - "description": "Reads rows from the database using key lookups and scans, as a simple key/value style alternative to ExecuteSql. This method cannot be used to return a result set larger than 10 MiB; if the read matches more data than that, the read fails with a `FAILED_PRECONDITION` error. Reads inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be yielded in streaming fashion by calling StreamingRead instead.", + "description": "Reads rows from the database using key lookups and scans, as a simple key/value style alternative to ExecuteSql. This method can't be used to return a result set larger than 10 MiB; if the read matches more data than that, the read fails with a `FAILED_PRECONDITION` error. Reads inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be yielded in streaming fashion by calling StreamingRead instead.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:read", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.read", @@ -2815,7 +2815,7 @@ ] }, "rollback": { - "description": "Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any transaction that includes one or more Read or ExecuteSql requests and ultimately decides not to commit. `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was already aborted, or the transaction is not found. `Rollback` never returns `ABORTED`.", + "description": "Rolls back a transaction, releasing any locks it holds. It's a good idea to call this for any transaction that includes one or more Read or ExecuteSql requests and ultimately decides not to commit. `Rollback` returns `OK` if it successfully aborts the transaction, the transaction was already aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/sessions/{sessionsId}:rollback", "httpMethod": "POST", "id": "spanner.projects.instances.databases.sessions.rollback", @@ -3406,7 +3406,7 @@ } } }, - "revision": "20250220", + "revision": "20250304", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AdaptMessageRequest": { @@ -3814,13 +3814,13 @@ "id": "BatchCreateSessionsRequest", "properties": { "sessionCount": { - "description": "Required. The number of sessions to be created in this batch call. The API may return fewer than the requested number of sessions. If a specific number of sessions are desired, the client can make additional calls to BatchCreateSessions (adjusting session_count as necessary).", + "description": "Required. The number of sessions to be created in this batch call. The API can return fewer than the requested number of sessions. If a specific number of sessions are desired, the client can make additional calls to `BatchCreateSessions` (adjusting session_count as necessary).", "format": "int32", "type": "integer" }, "sessionTemplate": { "$ref": "Session", - "description": "Parameters to be applied to each created session." + "description": "Parameters to apply to each created session." } }, "type": "object" @@ -3844,7 +3844,7 @@ "id": "BatchWriteRequest", "properties": { "excludeTxnFromChangeStreams": { - "description": "Optional. When `exclude_txn_from_change_streams` is set to `true`: * Modifications from all transactions in this batch write operation will not be recorded in change streams with DDL option `allow_txn_exclusion=true` that are tracking columns modified by these transactions. * Modifications from all transactions in this batch write operation will be recorded in change streams with DDL option `allow_txn_exclusion=false or not set` that are tracking columns modified by these transactions. When `exclude_txn_from_change_streams` is set to `false` or not set, Modifications from all transactions in this batch write operation will be recorded in all change streams that are tracking columns modified by these transactions.", + "description": "Optional. When `exclude_txn_from_change_streams` is set to `true`: * Modifications from all transactions in this batch write operation are not be recorded in change streams with DDL option `allow_txn_exclusion=true` that are tracking columns modified by these transactions. * Modifications from all transactions in this batch write operation are recorded in change streams with DDL option `allow_txn_exclusion=false or not set` that are tracking columns modified by these transactions. When `exclude_txn_from_change_streams` is set to `false` or not set, Modifications from all transactions in this batch write operation are recorded in all change streams that are tracking columns modified by these transactions.", "type": "boolean" }, "mutationGroups": { @@ -3891,7 +3891,7 @@ "properties": { "mutationKey": { "$ref": "Mutation", - "description": "Optional. Required for read-write transactions on a multiplexed session that commit mutations but do not perform any reads or queries. Clients should randomly select one of the mutations from the mutation set and send it as a part of this request." + "description": "Optional. Required for read-write transactions on a multiplexed session that commit mutations but don't perform any reads or queries. You must randomly select one of the mutations from the mutation set and send it as a part of this request." }, "options": { "$ref": "TransactionOptions", @@ -3899,7 +3899,7 @@ }, "requestOptions": { "$ref": "RequestOptions", - "description": "Common options for this request. Priority is ignored for this request. Setting the priority in this request_options struct will not do anything. To set the priority for a transaction, set it on the reads and writes that are part of this transaction instead." + "description": "Common options for this request. Priority is ignored for this request. Setting the priority in this `request_options` struct doesn't do anything. To set the priority for a transaction, set it on the reads and writes that are part of this transaction instead." } }, "type": "object" @@ -3991,7 +3991,7 @@ "id": "CommitRequest", "properties": { "maxCommitDelay": { - "description": "Optional. The amount of latency this request is configured to incur in order to improve throughput. If this field is not set, Spanner assumes requests are relatively latency sensitive and automatically determines an appropriate delay time. You can specify a commit delay value between 0 and 500 ms.", + "description": "Optional. The amount of latency this request is configured to incur in order to improve throughput. If this field isn't set, Spanner assumes requests are relatively latency sensitive and automatically determines an appropriate delay time. You can specify a commit delay value between 0 and 500 ms.", "format": "google-duration", "type": "string" }, @@ -4004,19 +4004,19 @@ }, "precommitToken": { "$ref": "MultiplexedSessionPrecommitToken", - "description": "Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error." + "description": "Optional. If the read-write transaction was executed on a multiplexed session, then you must include the precommit token with the highest sequence number received in this transaction attempt. Failing to do so results in a `FailedPrecondition` error." }, "requestOptions": { "$ref": "RequestOptions", "description": "Common options for this request." }, "returnCommitStats": { - "description": "If `true`, then statistics related to the transaction will be included in the CommitResponse. Default value is `false`.", + "description": "If `true`, then statistics related to the transaction is included in the CommitResponse. Default value is `false`.", "type": "boolean" }, "singleUseTransaction": { "$ref": "TransactionOptions", - "description": "Execute mutations in a temporary transaction. Note that unlike commit of a previously-started transaction, commit with a temporary transaction is non-idempotent. That is, if the `CommitRequest` is sent to Cloud Spanner more than once (for instance, due to retries in the application, or in the transport library), it is possible that the mutations are executed more than once. If this is undesirable, use BeginTransaction and Commit instead." + "description": "Execute mutations in a temporary transaction. Note that unlike commit of a previously-started transaction, commit with a temporary transaction is non-idempotent. That is, if the `CommitRequest` is sent to Cloud Spanner more than once (for instance, due to retries in the application, or in the transport library), it's possible that the mutations are executed more than once. If this is undesirable, use BeginTransaction and Commit instead." }, "transactionId": { "description": "Commit a previously-started transaction.", @@ -4032,7 +4032,7 @@ "properties": { "commitStats": { "$ref": "CommitStats", - "description": "The statistics about this Commit. Not returned by default. For more information, see CommitRequest.return_commit_stats." + "description": "The statistics about this `Commit`. Not returned by default. For more information, see CommitRequest.return_commit_stats." }, "commitTimestamp": { "description": "The Cloud Spanner timestamp at which the transaction committed.", @@ -4041,7 +4041,7 @@ }, "precommitToken": { "$ref": "MultiplexedSessionPrecommitToken", - "description": "If specified, transaction has not committed yet. Clients must retry the commit with the new precommit token." + "description": "If specified, transaction has not committed yet. You must retry the commit with the new precommit token." } }, "type": "object" @@ -4658,16 +4658,16 @@ "type": "object" }, "DirectedReadOptions": { - "description": "The DirectedReadOptions can be used to indicate which replicas or regions should be used for non-transactional reads or queries. DirectedReadOptions may only be specified for a read-only transaction, otherwise the API will return an `INVALID_ARGUMENT` error.", + "description": "The `DirectedReadOptions` can be used to indicate which replicas or regions should be used for non-transactional reads or queries. `DirectedReadOptions` can only be specified for a read-only transaction, otherwise the API returns an `INVALID_ARGUMENT` error.", "id": "DirectedReadOptions", "properties": { "excludeReplicas": { "$ref": "ExcludeReplicas", - "description": "Exclude_replicas indicates that specified replicas should be excluded from serving requests. Spanner will not route requests to the replicas in this list." + "description": "`Exclude_replicas` indicates that specified replicas should be excluded from serving requests. Spanner doesn't route requests to the replicas in this list." }, "includeReplicas": { "$ref": "IncludeReplicas", - "description": "Include_replicas indicates the order of replicas (as they appear in this list) to process the request. If auto_failover_disabled is set to true and all replicas are exhausted without finding a healthy replica, Spanner will wait for a replica in the list to become available, requests may fail due to `DEADLINE_EXCEEDED` errors." + "description": "`Include_replicas` indicates the order of replicas (as they appear in this list) to process the request. If `auto_failover_disabled` is set to `true` and all replicas are exhausted without finding a healthy replica, Spanner waits for a replica in the list to become available, requests might fail due to `DEADLINE_EXCEEDED` errors." } }, "type": "object" @@ -4753,7 +4753,7 @@ "id": "ExecuteBatchDmlRequest", "properties": { "lastStatements": { - "description": "Optional. If set to true, this request marks the end of the transaction. The transaction should be committed or aborted after these statements execute, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. Setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of statements should not be assumed until a subsequent Commit call completes successfully.", + "description": "Optional. If set to `true`, this request marks the end of the transaction. After these statements execute, you must commit or abort the transaction. Attempts to execute any other requests against this transaction (including reads and queries) are rejected. Setting this option might cause some error reporting to be deferred until commit time (for example, validation of unique constraints). Given this, successful execution of statements shouldn't be assumed until a subsequent `Commit` call completes successfully.", "type": "boolean" }, "requestOptions": { @@ -4761,7 +4761,7 @@ "description": "Common options for this request." }, "seqno": { - "description": "Required. A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one will succeed. The sequence number must be monotonically increasing within the transaction. If a request arrives for the first time with an out-of-order sequence number, the transaction may be aborted. Replays of previously handled requests will yield the same response as the first execution.", + "description": "Required. A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one succeeds. The sequence number must be monotonically increasing within the transaction. If a request arrives for the first time with an out-of-order sequence number, the transaction might be aborted. Replays of previously handled requests yield the same response as the first execution.", "format": "int64", "type": "string" }, @@ -4785,7 +4785,7 @@ "properties": { "precommitToken": { "$ref": "MultiplexedSessionPrecommitToken", - "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + "description": "Optional. A precommit token is included if the read-write transaction is on a multiplexed session. Pass the precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." }, "resultSets": { "description": "One ResultSet for each statement in the request that ran successfully, in the same order as the statements in the request. Each ResultSet does not contain any rows. The ResultSetStats in each ResultSet contain the number of rows modified by the statement. Only the first ResultSet in the response contains valid ResultSetMetadata.", @@ -4806,7 +4806,7 @@ "id": "ExecuteSqlRequest", "properties": { "dataBoostEnabled": { - "description": "If this is for a partitioned query and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request does not set `partition_token`, the API returns an `INVALID_ARGUMENT` error.", + "description": "If this is for a partitioned query and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request doesn't set `partition_token`, the API returns an `INVALID_ARGUMENT` error.", "type": "boolean" }, "directedReadOptions": { @@ -4814,14 +4814,14 @@ "description": "Directed read options for this request." }, "lastStatement": { - "description": "Optional. If set to true, this statement marks the end of the transaction. The transaction should be committed or aborted after this statement executes, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. For DML statements, setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of a DML statement should not be assumed until a subsequent Commit call completes successfully.", + "description": "Optional. If set to `true`, this statement marks the end of the transaction. After this statement executes, you must commit or abort the transaction. Attempts to execute any other requests against this transaction (including reads and queries) are rejected. For DML statements, setting this option might cause some error reporting to be deferred until commit time (for example, validation of unique constraints). Given this, successful execution of a DML statement shouldn't be assumed until a subsequent `Commit` call completes successfully.", "type": "boolean" }, "paramTypes": { "additionalProperties": { "$ref": "Type" }, - "description": "It is not always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL statement parameters. See the definition of Type for more information about SQL types.", + "description": "It isn't always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, you can use `param_types` to specify the exact SQL type for some or all of the SQL statement parameters. See the definition of Type for more information about SQL types.", "type": "object" }, "params": { @@ -4829,11 +4829,11 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names must conform to the naming requirements of identifiers as specified at https://cloud.google.com/spanner/docs/lexical#identifiers. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `\"WHERE id \u003e @msg_id AND id \u003c @msg_id + 100\"` It is an error to execute a SQL statement with unbound parameters.", + "description": "Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names must conform to the naming requirements of identifiers as specified at https://cloud.google.com/spanner/docs/lexical#identifiers. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `\"WHERE id \u003e @msg_id AND id \u003c @msg_id + 100\"` It's an error to execute a SQL statement with unbound parameters.", "type": "object" }, "partitionToken": { - "description": "If present, results will be restricted to the specified partition previously created using PartitionQuery(). There must be an exact match for the values of fields common to this message and the PartitionQueryRequest message used to create this partition_token.", + "description": "If present, results are restricted to the specified partition previously created using `PartitionQuery`. There must be an exact match for the values of fields common to this message and the `PartitionQueryRequest` message used to create this `partition_token`.", "format": "byte", "type": "string" }, @@ -4849,7 +4849,7 @@ "enumDescriptions": [ "The default mode. Only the statement results are returned.", "This mode returns only the query plan, without any results or execution statistics information.", - "This mode returns the query plan, overall execution statistics, operator level execution statistics along with the results. This has a performance overhead compared to the other modes. It is not recommended to use this mode for production traffic.", + "This mode returns the query plan, overall execution statistics, operator level execution statistics along with the results. This has a performance overhead compared to the other modes. It isn't recommended to use this mode for production traffic.", "This mode returns the overall (but not operator-level) execution statistics along with the results.", "This mode returns the query plan, overall (but not operator-level) execution statistics along with the results." ], @@ -4869,7 +4869,7 @@ "type": "string" }, "seqno": { - "description": "A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one will succeed. The sequence number must be monotonically increasing within the transaction. If a request arrives for the first time with an out-of-order sequence number, the transaction may be aborted. Replays of previously handled requests will yield the same response as the first execution. Required for DML statements. Ignored for queries.", + "description": "A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one succeeds. The sequence number must be monotonically increasing within the transaction. If a request arrives for the first time with an out-of-order sequence number, the transaction can be aborted. Replays of previously handled requests yield the same response as the first execution. Required for DML statements. Ignored for queries.", "format": "int64", "type": "string" }, @@ -5004,11 +5004,11 @@ "type": "object" }, "IncludeReplicas": { - "description": "An IncludeReplicas contains a repeated set of ReplicaSelection which indicates the order in which replicas should be considered.", + "description": "An `IncludeReplicas` contains a repeated set of `ReplicaSelection` which indicates the order in which replicas should be considered.", "id": "IncludeReplicas", "properties": { "autoFailoverDisabled": { - "description": "If true, Spanner will not route requests to a replica outside the include_replicas list when all of the specified replicas are unavailable or unhealthy. Default value is `false`.", + "description": "If `true`, Spanner doesn't route requests to a replica outside the \u003c`include_replicas` list when all of the specified replicas are unavailable or unhealthy. Default value is `false`.", "type": "boolean" }, "replicaSelections": { @@ -5999,7 +5999,7 @@ "type": "object" }, "MultiplexedSessionPrecommitToken": { - "description": "When a read-write transaction is executed on a multiplexed session, this precommit token is sent back to the client as a part of the [Transaction] message in the BeginTransaction response and also as a part of the [ResultSet] and [PartialResultSet] responses.", + "description": "When a read-write transaction is executed on a multiplexed session, this precommit token is sent back to the client as a part of the Transaction message in the BeginTransaction response and also as a part of the ResultSet and PartialResultSet responses.", "id": "MultiplexedSessionPrecommitToken", "properties": { "precommitToken": { @@ -6136,13 +6136,17 @@ "description": "If true, then the final value in values is chunked, and must be combined with more values from subsequent `PartialResultSet`s to obtain a complete field value.", "type": "boolean" }, + "last": { + "description": "Optional. Indicates whether this is the last `PartialResultSet` in the stream. The server might optionally set this field. Clients shouldn't rely on this field being set in all cases.", + "type": "boolean" + }, "metadata": { "$ref": "ResultSetMetadata", "description": "Metadata about the result set, such as row type information. Only present in the first response." }, "precommitToken": { "$ref": "MultiplexedSessionPrecommitToken", - "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + "description": "Optional. A precommit token is included if the read-write transaction has multiplexed sessions enabled. Pass the precommit token with the highest sequence number from this transaction attempt to the Commit request for this transaction." }, "resumeToken": { "description": "Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss. If this occurs, the stream of results can be resumed by re-sending the original request and including `resume_token`. Note that executing any other transaction in the same session invalidates the token.", @@ -6151,10 +6155,10 @@ }, "stats": { "$ref": "ResultSetStats", - "description": "Query plan and execution statistics for the statement that produced this streaming result set. These can be requested by setting ExecuteSqlRequest.query_mode and are sent only once with the last response in the stream. This field will also be present in the last response for DML statements." + "description": "Query plan and execution statistics for the statement that produced this streaming result set. These can be requested by setting ExecuteSqlRequest.query_mode and are sent only once with the last response in the stream. This field is also present in the last response for DML statements." }, "values": { - "description": "A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values. Every N complete values defines a row, where N is equal to the number of entries in metadata.row_type.fields. Most values are encoded based on type as described here. It is possible that the last value in values is \"chunked\", meaning that the rest of the value is sent in subsequent `PartialResultSet`(s). This is denoted by the chunked_value field. Two or more chunked values can be merged to form a complete value as follows: * `bool/number/null`: cannot be chunked * `string`: concatenate the strings * `list`: concatenate the lists. If the last element in a list is a `string`, `list`, or `object`, merge it with the first element in the next list by applying these rules recursively. * `object`: concatenate the (field name, field value) pairs. If a field name is duplicated, then apply these rules recursively to merge the field values. Some examples of merging: # Strings are concatenated. \"foo\", \"bar\" =\u003e \"foobar\" # Lists of non-strings are concatenated. [2, 3], [4] =\u003e [2, 3, 4] # Lists are concatenated, but the last and first elements are merged # because they are strings. [\"a\", \"b\"], [\"c\", \"d\"] =\u003e [\"a\", \"bc\", \"d\"] # Lists are concatenated, but the last and first elements are merged # because they are lists. Recursively, the last and first elements # of the inner lists are merged because they are strings. [\"a\", [\"b\", \"c\"]], [[\"d\"], \"e\"] =\u003e [\"a\", [\"b\", \"cd\"], \"e\"] # Non-overlapping object fields are combined. {\"a\": \"1\"}, {\"b\": \"2\"} =\u003e {\"a\": \"1\", \"b\": 2\"} # Overlapping object fields are merged. {\"a\": \"1\"}, {\"a\": \"2\"} =\u003e {\"a\": \"12\"} # Examples of merging objects containing lists of strings. {\"a\": [\"1\"]}, {\"a\": [\"2\"]} =\u003e {\"a\": [\"12\"]} For a more complete example, suppose a streaming SQL query is yielding a result set whose rows contain a single string field. The following `PartialResultSet`s might be yielded: { \"metadata\": { ... } \"values\": [\"Hello\", \"W\"] \"chunked_value\": true \"resume_token\": \"Af65...\" } { \"values\": [\"orl\"] \"chunked_value\": true } { \"values\": [\"d\"] \"resume_token\": \"Zx1B...\" } This sequence of `PartialResultSet`s encodes two rows, one containing the field value `\"Hello\"`, and a second containing the field value `\"World\" = \"W\" + \"orl\" + \"d\"`. Not all `PartialResultSet`s contain a `resume_token`. Execution can only be resumed from a previously yielded `resume_token`. For the above sequence of `PartialResultSet`s, resuming the query with `\"resume_token\": \"Af65...\"` will yield results from the `PartialResultSet` with value `[\"orl\"]`.", + "description": "A streamed result set consists of a stream of values, which might be split into many `PartialResultSet` messages to accommodate large rows and/or large values. Every N complete values defines a row, where N is equal to the number of entries in metadata.row_type.fields. Most values are encoded based on type as described here. It's possible that the last value in values is \"chunked\", meaning that the rest of the value is sent in subsequent `PartialResultSet`(s). This is denoted by the chunked_value field. Two or more chunked values can be merged to form a complete value as follows: * `bool/number/null`: can't be chunked * `string`: concatenate the strings * `list`: concatenate the lists. If the last element in a list is a `string`, `list`, or `object`, merge it with the first element in the next list by applying these rules recursively. * `object`: concatenate the (field name, field value) pairs. If a field name is duplicated, then apply these rules recursively to merge the field values. Some examples of merging: Strings are concatenated. \"foo\", \"bar\" =\u003e \"foobar\" Lists of non-strings are concatenated. [2, 3], [4] =\u003e [2, 3, 4] Lists are concatenated, but the last and first elements are merged because they are strings. [\"a\", \"b\"], [\"c\", \"d\"] =\u003e [\"a\", \"bc\", \"d\"] Lists are concatenated, but the last and first elements are merged because they are lists. Recursively, the last and first elements of the inner lists are merged because they are strings. [\"a\", [\"b\", \"c\"]], [[\"d\"], \"e\"] =\u003e [\"a\", [\"b\", \"cd\"], \"e\"] Non-overlapping object fields are combined. {\"a\": \"1\"}, {\"b\": \"2\"} =\u003e {\"a\": \"1\", \"b\": 2\"} Overlapping object fields are merged. {\"a\": \"1\"}, {\"a\": \"2\"} =\u003e {\"a\": \"12\"} Examples of merging objects containing lists of strings. {\"a\": [\"1\"]}, {\"a\": [\"2\"]} =\u003e {\"a\": [\"12\"]} For a more complete example, suppose a streaming SQL query is yielding a result set whose rows contain a single string field. The following `PartialResultSet`s might be yielded: { \"metadata\": { ... } \"values\": [\"Hello\", \"W\"] \"chunked_value\": true \"resume_token\": \"Af65...\" } { \"values\": [\"orl\"] \"chunked_value\": true } { \"values\": [\"d\"] \"resume_token\": \"Zx1B...\" } This sequence of `PartialResultSet`s encodes two rows, one containing the field value `\"Hello\"`, and a second containing the field value `\"World\" = \"W\" + \"orl\" + \"d\"`. Not all `PartialResultSet`s contain a `resume_token`. Execution can only be resumed from a previously yielded `resume_token`. For the above sequence of `PartialResultSet`s, resuming the query with `\"resume_token\": \"Af65...\"` yields results from the `PartialResultSet` with value \"orl\".", "items": { "type": "any" }, @@ -6168,7 +6172,7 @@ "id": "Partition", "properties": { "partitionToken": { - "description": "This token can be passed to Read, StreamingRead, ExecuteSql, or ExecuteStreamingSql requests to restrict the results to those identified by this partition token.", + "description": "This token can be passed to `Read`, `StreamingRead`, `ExecuteSql`, or `ExecuteStreamingSql` requests to restrict the results to those identified by this partition token.", "format": "byte", "type": "string" } @@ -6176,16 +6180,16 @@ "type": "object" }, "PartitionOptions": { - "description": "Options for a PartitionQueryRequest and PartitionReadRequest.", + "description": "Options for a `PartitionQueryRequest` and `PartitionReadRequest`.", "id": "PartitionOptions", "properties": { "maxPartitions": { - "description": "**Note:** This hint is currently ignored by PartitionQuery and PartitionRead requests. The desired maximum number of partitions to return. For example, this may be set to the number of workers available. The default for this option is currently 10,000. The maximum value is currently 200,000. This is only a hint. The actual number of partitions returned may be smaller or larger than this maximum count request.", + "description": "**Note:** This hint is currently ignored by `PartitionQuery` and `PartitionRead` requests. The desired maximum number of partitions to return. For example, this might be set to the number of workers available. The default for this option is currently 10,000. The maximum value is currently 200,000. This is only a hint. The actual number of partitions returned can be smaller or larger than this maximum count request.", "format": "int64", "type": "string" }, "partitionSizeBytes": { - "description": "**Note:** This hint is currently ignored by PartitionQuery and PartitionRead requests. The desired data size for each partition generated. The default for this option is currently 1 GiB. This is only a hint. The actual size of each partition may be smaller or larger than this size request.", + "description": "**Note:** This hint is currently ignored by `PartitionQuery` and `PartitionRead` requests. The desired data size for each partition generated. The default for this option is currently 1 GiB. This is only a hint. The actual size of each partition can be smaller or larger than this size request.", "format": "int64", "type": "string" } @@ -6200,7 +6204,7 @@ "additionalProperties": { "$ref": "Type" }, - "description": "It is not always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL query parameters. See the definition of Type for more information about SQL types.", + "description": "It isn't always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL query parameters. See the definition of Type for more information about SQL types.", "type": "object" }, "params": { @@ -6208,7 +6212,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names can contain letters, numbers, and underscores. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `\"WHERE id \u003e @msg_id AND id \u003c @msg_id + 100\"` It is an error to execute a SQL statement with unbound parameters.", + "description": "Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names can contain letters, numbers, and underscores. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `\"WHERE id \u003e @msg_id AND id \u003c @msg_id + 100\"` It's an error to execute a SQL statement with unbound parameters.", "type": "object" }, "partitionOptions": { @@ -6216,12 +6220,12 @@ "description": "Additional options that affect how many partitions are created." }, "sql": { - "description": "Required. The query request to generate partitions for. The request fails if the query is not root partitionable. For a query to be root partitionable, it needs to satisfy a few conditions. For example, if the query execution plan contains a distributed union operator, then it must be the first operator in the plan. For more information about other conditions, see [Read data in parallel](https://cloud.google.com/spanner/docs/reads#read_data_in_parallel). The query request must not contain DML commands, such as `INSERT`, `UPDATE`, or `DELETE`. Use `ExecuteStreamingSql` with a PartitionedDml transaction for large, partition-friendly DML operations.", + "description": "Required. The query request to generate partitions for. The request fails if the query isn't root partitionable. For a query to be root partitionable, it needs to satisfy a few conditions. For example, if the query execution plan contains a distributed union operator, then it must be the first operator in the plan. For more information about other conditions, see [Read data in parallel](https://cloud.google.com/spanner/docs/reads#read_data_in_parallel). The query request must not contain DML commands, such as `INSERT`, `UPDATE`, or `DELETE`. Use `ExecuteStreamingSql` with a `PartitionedDml` transaction for large, partition-friendly DML operations.", "type": "string" }, "transaction": { "$ref": "TransactionSelector", - "description": "Read only snapshot transactions are supported, read/write and single use transactions are not." + "description": "Read-only snapshot transactions are supported, read and write and single-use transactions are not." } }, "type": "object" @@ -6243,7 +6247,7 @@ }, "keySet": { "$ref": "KeySet", - "description": "Required. `key_set` identifies the rows to be yielded. `key_set` names the primary keys of the rows in table to be yielded, unless index is present. If index is present, then key_set instead names index keys in index. It is not an error for the `key_set` to name rows that do not exist in the database. Read yields nothing for nonexistent rows." + "description": "Required. `key_set` identifies the rows to be yielded. `key_set` names the primary keys of the rows in table to be yielded, unless index is present. If index is present, then key_set instead names index keys in index. It isn't an error for the `key_set` to name rows that don't exist in the database. Read yields nothing for nonexistent rows." }, "partitionOptions": { "$ref": "PartitionOptions", @@ -6414,11 +6418,11 @@ "id": "QueryOptions", "properties": { "optimizerStatisticsPackage": { - "description": "An option to control the selection of optimizer statistics package. This parameter allows individual queries to use a different query optimizer statistics package. Specifying `latest` as a value instructs Cloud Spanner to use the latest generated statistics package. If not specified, Cloud Spanner uses the statistics package set at the database level options, or the latest package if the database option is not set. The statistics package requested by the query has to be exempt from garbage collection. This can be achieved with the following DDL statement: ``` ALTER STATISTICS SET OPTIONS (allow_gc=false) ``` The list of available statistics packages can be queried from `INFORMATION_SCHEMA.SPANNER_STATISTICS`. Executing a SQL statement with an invalid optimizer statistics package or with a statistics package that allows garbage collection fails with an `INVALID_ARGUMENT` error.", + "description": "An option to control the selection of optimizer statistics package. This parameter allows individual queries to use a different query optimizer statistics package. Specifying `latest` as a value instructs Cloud Spanner to use the latest generated statistics package. If not specified, Cloud Spanner uses the statistics package set at the database level options, or the latest package if the database option isn't set. The statistics package requested by the query has to be exempt from garbage collection. This can be achieved with the following DDL statement: ```sql ALTER STATISTICS SET OPTIONS (allow_gc=false) ``` The list of available statistics packages can be queried from `INFORMATION_SCHEMA.SPANNER_STATISTICS`. Executing a SQL statement with an invalid optimizer statistics package or with a statistics package that allows garbage collection fails with an `INVALID_ARGUMENT` error.", "type": "string" }, "optimizerVersion": { - "description": "An option to control the selection of optimizer version. This parameter allows individual queries to pick different query optimizer versions. Specifying `latest` as a value instructs Cloud Spanner to use the latest supported query optimizer version. If not specified, Cloud Spanner uses the optimizer version set at the database level options. Any other positive integer (from the list of supported optimizer versions) overrides the default optimizer version for query execution. The list of supported optimizer versions can be queried from SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement with an invalid optimizer version fails with an `INVALID_ARGUMENT` error. See https://cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer for more information on managing the query optimizer. The `optimizer_version` statement hint has precedence over this setting.", + "description": "An option to control the selection of optimizer version. This parameter allows individual queries to pick different query optimizer versions. Specifying `latest` as a value instructs Cloud Spanner to use the latest supported query optimizer version. If not specified, Cloud Spanner uses the optimizer version set at the database level options. Any other positive integer (from the list of supported optimizer versions) overrides the default optimizer version for query execution. The list of supported optimizer versions can be queried from `SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS`. Executing a SQL statement with an invalid optimizer version fails with an `INVALID_ARGUMENT` error. See https://cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer for more information on managing the query optimizer. The `optimizer_version` statement hint has precedence over this setting.", "type": "string" } }, @@ -6542,7 +6546,7 @@ "type": "array" }, "dataBoostEnabled": { - "description": "If this is for a partitioned read and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request does not set `partition_token`, the API returns an `INVALID_ARGUMENT` error.", + "description": "If this is for a partitioned read and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request doesn't set `partition_token`, the API returns an `INVALID_ARGUMENT` error.", "type": "boolean" }, "directedReadOptions": { @@ -6555,10 +6559,10 @@ }, "keySet": { "$ref": "KeySet", - "description": "Required. `key_set` identifies the rows to be yielded. `key_set` names the primary keys of the rows in table to be yielded, unless index is present. If index is present, then key_set instead names index keys in index. If the partition_token field is empty, rows are yielded in table primary key order (if index is empty) or index key order (if index is non-empty). If the partition_token field is not empty, rows will be yielded in an unspecified order. It is not an error for the `key_set` to name rows that do not exist in the database. Read yields nothing for nonexistent rows." + "description": "Required. `key_set` identifies the rows to be yielded. `key_set` names the primary keys of the rows in table to be yielded, unless index is present. If index is present, then key_set instead names index keys in index. If the partition_token field is empty, rows are yielded in table primary key order (if index is empty) or index key order (if index is non-empty). If the partition_token field isn't empty, rows are yielded in an unspecified order. It isn't an error for the `key_set` to name rows that don't exist in the database. Read yields nothing for nonexistent rows." }, "limit": { - "description": "If greater than zero, only the first `limit` rows are yielded. If `limit` is zero, the default is no limit. A limit cannot be specified if `partition_token` is set.", + "description": "If greater than zero, only the first `limit` rows are yielded. If `limit` is zero, the default is no limit. A limit can't be specified if `partition_token` is set.", "format": "int64", "type": "string" }, @@ -6570,28 +6574,28 @@ "LOCK_HINT_EXCLUSIVE" ], "enumDescriptions": [ - "Default value. LOCK_HINT_UNSPECIFIED is equivalent to LOCK_HINT_SHARED.", + "Default value. `LOCK_HINT_UNSPECIFIED` is equivalent to `LOCK_HINT_SHARED`.", "Acquire shared locks. By default when you perform a read as part of a read-write transaction, Spanner acquires shared read locks, which allows other reads to still access the data until your transaction is ready to commit. When your transaction is committing and writes are being applied, the transaction attempts to upgrade to an exclusive lock for any data you are writing. For more information about locks, see [Lock modes](https://cloud.google.com/spanner/docs/introspection/lock-statistics#explain-lock-modes).", - "Acquire exclusive locks. Requesting exclusive locks is beneficial if you observe high write contention, which means you notice that multiple transactions are concurrently trying to read and write to the same data, resulting in a large number of aborts. This problem occurs when two transactions initially acquire shared locks and then both try to upgrade to exclusive locks at the same time. In this situation both transactions are waiting for the other to give up their lock, resulting in a deadlocked situation. Spanner is able to detect this occurring and force one of the transactions to abort. However, this is a slow and expensive operation and results in lower performance. In this case it makes sense to acquire exclusive locks at the start of the transaction because then when multiple transactions try to act on the same data, they automatically get serialized. Each transaction waits its turn to acquire the lock and avoids getting into deadlock situations. Because the exclusive lock hint is just a hint, it should not be considered equivalent to a mutex. In other words, you should not use Spanner exclusive locks as a mutual exclusion mechanism for the execution of code outside of Spanner. **Note:** Request exclusive locks judiciously because they block others from reading that data for the entire transaction, rather than just when the writes are being performed. Unless you observe high write contention, you should use the default of shared read locks so you don't prematurely block other clients from reading the data that you're writing to." + "Acquire exclusive locks. Requesting exclusive locks is beneficial if you observe high write contention, which means you notice that multiple transactions are concurrently trying to read and write to the same data, resulting in a large number of aborts. This problem occurs when two transactions initially acquire shared locks and then both try to upgrade to exclusive locks at the same time. In this situation both transactions are waiting for the other to give up their lock, resulting in a deadlocked situation. Spanner is able to detect this occurring and force one of the transactions to abort. However, this is a slow and expensive operation and results in lower performance. In this case it makes sense to acquire exclusive locks at the start of the transaction because then when multiple transactions try to act on the same data, they automatically get serialized. Each transaction waits its turn to acquire the lock and avoids getting into deadlock situations. Because the exclusive lock hint is just a hint, it shouldn't be considered equivalent to a mutex. In other words, you shouldn't use Spanner exclusive locks as a mutual exclusion mechanism for the execution of code outside of Spanner. **Note:** Request exclusive locks judiciously because they block others from reading that data for the entire transaction, rather than just when the writes are being performed. Unless you observe high write contention, you should use the default of shared read locks so you don't prematurely block other clients from reading the data that you're writing to." ], "type": "string" }, "orderBy": { - "description": "Optional. Order for the returned rows. By default, Spanner will return result rows in primary key order except for PartitionRead requests. For applications that do not require rows to be returned in primary key (`ORDER_BY_PRIMARY_KEY`) order, setting `ORDER_BY_NO_ORDER` option allows Spanner to optimize row retrieval, resulting in lower latencies in certain cases (e.g. bulk point lookups).", + "description": "Optional. Order for the returned rows. By default, Spanner returns result rows in primary key order except for PartitionRead requests. For applications that don't require rows to be returned in primary key (`ORDER_BY_PRIMARY_KEY`) order, setting `ORDER_BY_NO_ORDER` option allows Spanner to optimize row retrieval, resulting in lower latencies in certain cases (for example, bulk point lookups).", "enum": [ "ORDER_BY_UNSPECIFIED", "ORDER_BY_PRIMARY_KEY", "ORDER_BY_NO_ORDER" ], "enumDescriptions": [ - "Default value. ORDER_BY_UNSPECIFIED is equivalent to ORDER_BY_PRIMARY_KEY.", - "Read rows are returned in primary key order. In the event that this option is used in conjunction with the `partition_token` field, the API will return an `INVALID_ARGUMENT` error.", + "Default value. `ORDER_BY_UNSPECIFIED` is equivalent to `ORDER_BY_PRIMARY_KEY`.", + "Read rows are returned in primary key order. In the event that this option is used in conjunction with the `partition_token` field, the API returns an `INVALID_ARGUMENT` error.", "Read rows are returned in any order." ], "type": "string" }, "partitionToken": { - "description": "If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.", + "description": "If present, results are restricted to the specified partition previously created using `PartitionRead`. There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.", "format": "byte", "type": "string" }, @@ -6632,9 +6636,9 @@ "OPTIMISTIC" ], "enumDescriptions": [ - "Default value. If the value is not specified, the pessimistic read lock is used.", - "Pessimistic lock mode. Read locks are acquired immediately on read.", - "Optimistic lock mode. Locks for reads within the transaction are not acquired on read. Instead the locks are acquired on a commit to validate that read/queried data has not changed since the transaction started." + "Default value. * If isolation level is REPEATABLE_READ, then it is an error to specify `read_lock_mode`. Locking semantics default to `OPTIMISTIC`. No validation checks are done for reads, except to validate that the data that was served at the snapshot time is unchanged at commit time in the following cases: 1. reads done as part of queries that use `SELECT FOR UPDATE` 2. reads done as part of statements with a `LOCK_SCANNED_RANGES` hint 3. reads done as part of DML statements * At all other isolation levels, if `read_lock_mode` is the default value, then pessimistic read locks are used.", + "Pessimistic lock mode. Read locks are acquired immediately on read. Semantics described only applies to SERIALIZABLE isolation.", + "Optimistic lock mode. Locks for reads within the transaction are not acquired on read. Instead the locks are acquired on a commit to validate that read/queried data has not changed since the transaction started. Semantics described only applies to SERIALIZABLE isolation." ], "type": "string" } @@ -6693,11 +6697,11 @@ "type": "object" }, "ReplicaSelection": { - "description": "The directed read replica selector. Callers must provide one or more of the following fields for replica selection: * `location` - The location must be one of the regions within the multi-region configuration of your database. * `type` - The type of the replica. Some examples of using replica_selectors are: * `location:us-east1` --\u003e The \"us-east1\" replica(s) of any available type will be used to process the request. * `type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in nearest available location will be used to process the request. * `location:us-east1 type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in location \"us-east1\" will be used to process the request.", + "description": "The directed read replica selector. Callers must provide one or more of the following fields for replica selection: * `location` - The location must be one of the regions within the multi-region configuration of your database. * `type` - The type of the replica. Some examples of using replica_selectors are: * `location:us-east1` --\u003e The \"us-east1\" replica(s) of any available type is used to process the request. * `type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in the nearest available location are used to process the request. * `location:us-east1 type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in location \"us-east1\" is used to process the request.", "id": "ReplicaSelection", "properties": { "location": { - "description": "The location or region of the serving requests, e.g. \"us-east1\".", + "description": "The location or region of the serving requests, for example, \"us-east1\".", "type": "string" }, "type": { @@ -6738,11 +6742,11 @@ "type": "string" }, "requestTag": { - "description": "A per-request tag which can be applied to queries or reads, used for statistics collection. Both request_tag and transaction_tag can be specified for a read or query that belongs to a transaction. This field is ignored for requests where it's not applicable (e.g. CommitRequest). Legal characters for `request_tag` values are all printable characters (ASCII 32 - 126) and the length of a request_tag is limited to 50 characters. Values that exceed this limit are truncated. Any leading underscore (_) characters will be removed from the string.", + "description": "A per-request tag which can be applied to queries or reads, used for statistics collection. Both `request_tag` and `transaction_tag` can be specified for a read or query that belongs to a transaction. This field is ignored for requests where it's not applicable (for example, `CommitRequest`). Legal characters for `request_tag` values are all printable characters (ASCII 32 - 126) and the length of a request_tag is limited to 50 characters. Values that exceed this limit are truncated. Any leading underscore (_) characters are removed from the string.", "type": "string" }, "transactionTag": { - "description": "A tag used for statistics collection about this transaction. Both request_tag and transaction_tag can be specified for a read or query that belongs to a transaction. The value of transaction_tag should be the same for all requests belonging to the same transaction. If this request doesn't belong to any transaction, transaction_tag will be ignored. Legal characters for `transaction_tag` values are all printable characters (ASCII 32 - 126) and the length of a transaction_tag is limited to 50 characters. Values that exceed this limit are truncated. Any leading underscore (_) characters will be removed from the string.", + "description": "A tag used for statistics collection about this transaction. Both `request_tag` and `transaction_tag` can be specified for a read or query that belongs to a transaction. The value of transaction_tag should be the same for all requests belonging to the same transaction. If this request doesn't belong to any transaction, `transaction_tag` is ignored. Legal characters for `transaction_tag` values are all printable characters (ASCII 32 - 126) and the length of a `transaction_tag` is limited to 50 characters. Values that exceed this limit are truncated. Any leading underscore (_) characters are removed from the string.", "type": "string" } }, @@ -6874,7 +6878,7 @@ }, "precommitToken": { "$ref": "MultiplexedSessionPrecommitToken", - "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + "description": "Optional. A precommit token is included if the read-write transaction is on a multiplexed session. Pass the precommit token with the highest sequence number from this transaction attempt to the Commit request for this transaction." }, "rows": { "description": "Each element in `rows` is a row whose format is defined by metadata.row_type. The ith element in each row matches the ith field in metadata.row_type. Elements are encoded based on type as described here.", @@ -6888,7 +6892,7 @@ }, "stats": { "$ref": "ResultSetStats", - "description": "Query plan and execution statistics for the SQL statement that produced this result set. These can be requested by setting ExecuteSqlRequest.query_mode. DML statements always produce stats containing the number of rows modified, unless executed using the ExecuteSqlRequest.QueryMode.PLAN ExecuteSqlRequest.query_mode. Other fields may or may not be populated, based on the ExecuteSqlRequest.query_mode." + "description": "Query plan and execution statistics for the SQL statement that produced this result set. These can be requested by setting ExecuteSqlRequest.query_mode. DML statements always produce stats containing the number of rows modified, unless executed using the ExecuteSqlRequest.QueryMode.PLAN ExecuteSqlRequest.query_mode. Other fields might or might not be populated, based on the ExecuteSqlRequest.query_mode." } }, "type": "object" @@ -6934,7 +6938,7 @@ "type": "string" }, "rowCountLowerBound": { - "description": "Partitioned DML does not offer exactly-once semantics, so it returns a lower bound of the rows modified.", + "description": "Partitioned DML doesn't offer exactly-once semantics, so it returns a lower bound of the rows modified.", "format": "int64", "type": "string" } @@ -7013,7 +7017,7 @@ "id": "Session", "properties": { "approximateLastUseTime": { - "description": "Output only. The approximate timestamp when the session is last used. It is typically earlier than the actual last use time.", + "description": "Output only. The approximate timestamp when the session is last used. It's typically earlier than the actual last use time.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -7036,7 +7040,7 @@ "type": "object" }, "multiplexed": { - "description": "Optional. If true, specifies a multiplexed session. Use a multiplexed session for multiple, concurrent read-only operations. Don't use them for read-write transactions, partitioned reads, or partitioned queries. Use `sessions.create` to create multiplexed sessions. Don't use BatchCreateSessions to create a multiplexed session. You can't delete or list multiplexed sessions.", + "description": "Optional. If `true`, specifies a multiplexed session. Use a multiplexed session for multiple, concurrent read-only operations. Don't use them for read-write transactions, partitioned reads, or partitioned queries. Use `sessions.create` to create multiplexed sessions. Don't use BatchCreateSessions to create a multiplexed session. You can't delete or list multiplexed sessions.", "type": "boolean" }, "name": { @@ -7123,7 +7127,7 @@ "additionalProperties": { "$ref": "Type" }, - "description": "It is not always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL statement parameters. See the definition of Type for more information about SQL types.", + "description": "It isn't always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL statement parameters. See the definition of Type for more information about SQL types.", "type": "object" }, "params": { @@ -7131,7 +7135,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Parameter names and values that bind to placeholders in the DML string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names can contain letters, numbers, and underscores. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `\"WHERE id \u003e @msg_id AND id \u003c @msg_id + 100\"` It is an error to execute a SQL statement with unbound parameters.", + "description": "Parameter names and values that bind to placeholders in the DML string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names can contain letters, numbers, and underscores. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `\"WHERE id \u003e @msg_id AND id \u003c @msg_id + 100\"` It's an error to execute a SQL statement with unbound parameters.", "type": "object" }, "sql": { @@ -7239,6 +7243,20 @@ "description": "When `exclude_txn_from_change_streams` is set to `true`: * Modifications from this transaction will not be recorded in change streams with DDL option `allow_txn_exclusion=true` that are tracking columns modified by these transactions. * Modifications from this transaction will be recorded in change streams with DDL option `allow_txn_exclusion=false or not set` that are tracking columns modified by these transactions. When `exclude_txn_from_change_streams` is set to `false` or not set, Modifications from this transaction will be recorded in all change streams that are tracking columns modified by these transactions. `exclude_txn_from_change_streams` may only be specified for read-write or partitioned-dml transactions, otherwise the API will return an `INVALID_ARGUMENT` error.", "type": "boolean" }, + "isolationLevel": { + "description": "Isolation level for the transaction.", + "enum": [ + "ISOLATION_LEVEL_UNSPECIFIED", + "SERIALIZABLE", + "REPEATABLE_READ" + ], + "enumDescriptions": [ + "Default value. If the value is not specified, the `SERIALIZABLE` isolation level is used.", + "All transactions appear as if they executed in a serial order, even if some of the reads, writes, and other operations of distinct transactions actually occurred in parallel. Spanner assigns commit timestamps that reflect the order of committed transactions to implement this property. Spanner offers a stronger guarantee than serializability called external consistency. For further details, please refer to https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability.", + "All reads performed during the transaction observe a consistent snapshot of the database, and the transaction will only successfully commit in the absence of conflicts between its updates and any concurrent updates that have occurred since that snapshot. Consequently, in contrast to `SERIALIZABLE` transactions, only write-write conflicts are detected in snapshot transactions. This isolation level does not support Read-only and Partitioned DML transactions. When `REPEATABLE_READ` is specified on a read-write transaction, the locking semantics default to `OPTIMISTIC`." + ], + "type": "string" + }, "partitionedDml": { "$ref": "PartitionedDml", "description": "Partitioned DML transaction. Authorization to begin a Partitioned DML transaction requires `spanner.databases.beginPartitionedDmlTransaction` permission on the `session` resource." diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index ac14b7145d..eccc256c51 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -965,11 +965,11 @@ func (s BackupScheduleSpec) MarshalJSON() ([]byte, error) { // BatchCreateSessionsRequest: The request for BatchCreateSessions. type BatchCreateSessionsRequest struct { // SessionCount: Required. The number of sessions to be created in this batch - // call. The API may return fewer than the requested number of sessions. If a + // call. The API can return fewer than the requested number of sessions. If a // specific number of sessions are desired, the client can make additional - // calls to BatchCreateSessions (adjusting session_count as necessary). + // calls to `BatchCreateSessions` (adjusting session_count as necessary). SessionCount int64 `json:"sessionCount,omitempty"` - // SessionTemplate: Parameters to be applied to each created session. + // SessionTemplate: Parameters to apply to each created session. SessionTemplate *Session `json:"sessionTemplate,omitempty"` // ForceSendFields is a list of field names (e.g. "SessionCount") to // unconditionally include in API requests. By default, fields with empty or @@ -1018,15 +1018,15 @@ func (s BatchCreateSessionsResponse) MarshalJSON() ([]byte, error) { type BatchWriteRequest struct { // ExcludeTxnFromChangeStreams: Optional. When // `exclude_txn_from_change_streams` is set to `true`: * Modifications from all - // transactions in this batch write operation will not be recorded in change + // transactions in this batch write operation are not be recorded in change // streams with DDL option `allow_txn_exclusion=true` that are tracking columns // modified by these transactions. * Modifications from all transactions in - // this batch write operation will be recorded in change streams with DDL - // option `allow_txn_exclusion=false or not set` that are tracking columns - // modified by these transactions. When `exclude_txn_from_change_streams` is - // set to `false` or not set, Modifications from all transactions in this batch - // write operation will be recorded in all change streams that are tracking - // columns modified by these transactions. + // this batch write operation are recorded in change streams with DDL option + // `allow_txn_exclusion=false or not set` that are tracking columns modified by + // these transactions. When `exclude_txn_from_change_streams` is set to `false` + // or not set, Modifications from all transactions in this batch write + // operation are recorded in all change streams that are tracking columns + // modified by these transactions. ExcludeTxnFromChangeStreams bool `json:"excludeTxnFromChangeStreams,omitempty"` // MutationGroups: Required. The groups of mutations to be applied. MutationGroups []*MutationGroup `json:"mutationGroups,omitempty"` @@ -1085,14 +1085,14 @@ func (s BatchWriteResponse) MarshalJSON() ([]byte, error) { // BeginTransactionRequest: The request for BeginTransaction. type BeginTransactionRequest struct { // MutationKey: Optional. Required for read-write transactions on a multiplexed - // session that commit mutations but do not perform any reads or queries. - // Clients should randomly select one of the mutations from the mutation set - // and send it as a part of this request. + // session that commit mutations but don't perform any reads or queries. You + // must randomly select one of the mutations from the mutation set and send it + // as a part of this request. MutationKey *Mutation `json:"mutationKey,omitempty"` // Options: Required. Options for the new transaction. Options *TransactionOptions `json:"options,omitempty"` // RequestOptions: Common options for this request. Priority is ignored for - // this request. Setting the priority in this request_options struct will not + // this request. Setting the priority in this `request_options` struct doesn't // do anything. To set the priority for a transaction, set it on the reads and // writes that are part of this transaction instead. RequestOptions *RequestOptions `json:"requestOptions,omitempty"` @@ -1311,7 +1311,7 @@ func (s ChildLink) MarshalJSON() ([]byte, error) { // CommitRequest: The request for Commit. type CommitRequest struct { // MaxCommitDelay: Optional. The amount of latency this request is configured - // to incur in order to improve throughput. If this field is not set, Spanner + // to incur in order to improve throughput. If this field isn't set, Spanner // assumes requests are relatively latency sensitive and automatically // determines an appropriate delay time. You can specify a commit delay value // between 0 and 500 ms. @@ -1320,20 +1320,20 @@ type CommitRequest struct { // mutations are applied atomically, in the order they appear in this list. Mutations []*Mutation `json:"mutations,omitempty"` // PrecommitToken: Optional. If the read-write transaction was executed on a - // multiplexed session, the precommit token with the highest sequence number - // received in this transaction attempt, should be included here. Failing to do - // so will result in a FailedPrecondition error. + // multiplexed session, then you must include the precommit token with the + // highest sequence number received in this transaction attempt. Failing to do + // so results in a `FailedPrecondition` error. PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // RequestOptions: Common options for this request. RequestOptions *RequestOptions `json:"requestOptions,omitempty"` - // ReturnCommitStats: If `true`, then statistics related to the transaction - // will be included in the CommitResponse. Default value is `false`. + // ReturnCommitStats: If `true`, then statistics related to the transaction is + // included in the CommitResponse. Default value is `false`. ReturnCommitStats bool `json:"returnCommitStats,omitempty"` // SingleUseTransaction: Execute mutations in a temporary transaction. Note // that unlike commit of a previously-started transaction, commit with a // temporary transaction is non-idempotent. That is, if the `CommitRequest` is // sent to Cloud Spanner more than once (for instance, due to retries in the - // application, or in the transport library), it is possible that the mutations + // application, or in the transport library), it's possible that the mutations // are executed more than once. If this is undesirable, use BeginTransaction // and Commit instead. SingleUseTransaction *TransactionOptions `json:"singleUseTransaction,omitempty"` @@ -1359,14 +1359,14 @@ func (s CommitRequest) MarshalJSON() ([]byte, error) { // CommitResponse: The response for Commit. type CommitResponse struct { - // CommitStats: The statistics about this Commit. Not returned by default. For - // more information, see CommitRequest.return_commit_stats. + // CommitStats: The statistics about this `Commit`. Not returned by default. + // For more information, see CommitRequest.return_commit_stats. CommitStats *CommitStats `json:"commitStats,omitempty"` // CommitTimestamp: The Cloud Spanner timestamp at which the transaction // committed. CommitTimestamp string `json:"commitTimestamp,omitempty"` - // PrecommitToken: If specified, transaction has not committed yet. Clients - // must retry the commit with the new precommit token. + // PrecommitToken: If specified, transaction has not committed yet. You must + // retry the commit with the new precommit token. PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2275,20 +2275,20 @@ func (s DiagnosticMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// DirectedReadOptions: The DirectedReadOptions can be used to indicate which +// DirectedReadOptions: The `DirectedReadOptions` can be used to indicate which // replicas or regions should be used for non-transactional reads or queries. -// DirectedReadOptions may only be specified for a read-only transaction, -// otherwise the API will return an `INVALID_ARGUMENT` error. +// `DirectedReadOptions` can only be specified for a read-only transaction, +// otherwise the API returns an `INVALID_ARGUMENT` error. type DirectedReadOptions struct { - // ExcludeReplicas: Exclude_replicas indicates that specified replicas should - // be excluded from serving requests. Spanner will not route requests to the + // ExcludeReplicas: `Exclude_replicas` indicates that specified replicas should + // be excluded from serving requests. Spanner doesn't route requests to the // replicas in this list. ExcludeReplicas *ExcludeReplicas `json:"excludeReplicas,omitempty"` - // IncludeReplicas: Include_replicas indicates the order of replicas (as they - // appear in this list) to process the request. If auto_failover_disabled is - // set to true and all replicas are exhausted without finding a healthy - // replica, Spanner will wait for a replica in the list to become available, - // requests may fail due to `DEADLINE_EXCEEDED` errors. + // IncludeReplicas: `Include_replicas` indicates the order of replicas (as they + // appear in this list) to process the request. If `auto_failover_disabled` is + // set to `true` and all replicas are exhausted without finding a healthy + // replica, Spanner waits for a replica in the list to become available, + // requests might fail due to `DEADLINE_EXCEEDED` errors. IncludeReplicas *IncludeReplicas `json:"includeReplicas,omitempty"` // ForceSendFields is a list of field names (e.g. "ExcludeReplicas") to // unconditionally include in API requests. By default, fields with empty or @@ -2426,24 +2426,24 @@ func (s ExcludeReplicas) MarshalJSON() ([]byte, error) { // ExecuteBatchDmlRequest: The request for ExecuteBatchDml. type ExecuteBatchDmlRequest struct { - // LastStatements: Optional. If set to true, this request marks the end of the - // transaction. The transaction should be committed or aborted after these - // statements execute, and attempts to execute any other requests against this - // transaction (including reads and queries) will be rejected. Setting this - // option may cause some error reporting to be deferred until commit time (e.g. - // validation of unique constraints). Given this, successful execution of - // statements should not be assumed until a subsequent Commit call completes - // successfully. + // LastStatements: Optional. If set to `true`, this request marks the end of + // the transaction. After these statements execute, you must commit or abort + // the transaction. Attempts to execute any other requests against this + // transaction (including reads and queries) are rejected. Setting this option + // might cause some error reporting to be deferred until commit time (for + // example, validation of unique constraints). Given this, successful execution + // of statements shouldn't be assumed until a subsequent `Commit` call + // completes successfully. LastStatements bool `json:"lastStatements,omitempty"` // RequestOptions: Common options for this request. RequestOptions *RequestOptions `json:"requestOptions,omitempty"` // Seqno: Required. A per-transaction sequence number used to identify this // request. This field makes each request idempotent such that if the request - // is received multiple times, at most one will succeed. The sequence number - // must be monotonically increasing within the transaction. If a request - // arrives for the first time with an out-of-order sequence number, the - // transaction may be aborted. Replays of previously handled requests will - // yield the same response as the first execution. + // is received multiple times, at most one succeeds. The sequence number must + // be monotonically increasing within the transaction. If a request arrives for + // the first time with an out-of-order sequence number, the transaction might + // be aborted. Replays of previously handled requests yield the same response + // as the first execution. Seqno int64 `json:"seqno,omitempty,string"` // Statements: Required. The list of statements to execute in this batch. // Statements are executed serially, such that the effects of statement `i` are @@ -2491,10 +2491,10 @@ func (s ExecuteBatchDmlRequest) MarshalJSON() ([]byte, error) { // the third statement failed, and the fourth and fifth statements were not // executed. type ExecuteBatchDmlResponse struct { - // PrecommitToken: Optional. A precommit token will be included if the - // read-write transaction is on a multiplexed session. The precommit token with - // the highest sequence number from this transaction attempt should be passed - // to the Commit request for this transaction. + // PrecommitToken: Optional. A precommit token is included if the read-write + // transaction is on a multiplexed session. Pass the precommit token with the + // highest sequence number from this transaction attempt should be passed to + // the Commit request for this transaction. PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // ResultSets: One ResultSet for each statement in the request that ran // successfully, in the same order as the statements in the request. Each @@ -2530,26 +2530,26 @@ func (s ExecuteBatchDmlResponse) MarshalJSON() ([]byte, error) { type ExecuteSqlRequest struct { // DataBoostEnabled: If this is for a partitioned query and this field is set // to `true`, the request is executed with Spanner Data Boost independent - // compute resources. If the field is set to `true` but the request does not - // set `partition_token`, the API returns an `INVALID_ARGUMENT` error. + // compute resources. If the field is set to `true` but the request doesn't set + // `partition_token`, the API returns an `INVALID_ARGUMENT` error. DataBoostEnabled bool `json:"dataBoostEnabled,omitempty"` // DirectedReadOptions: Directed read options for this request. DirectedReadOptions *DirectedReadOptions `json:"directedReadOptions,omitempty"` - // LastStatement: Optional. If set to true, this statement marks the end of the - // transaction. The transaction should be committed or aborted after this - // statement executes, and attempts to execute any other requests against this - // transaction (including reads and queries) will be rejected. For DML - // statements, setting this option may cause some error reporting to be - // deferred until commit time (e.g. validation of unique constraints). Given - // this, successful execution of a DML statement should not be assumed until a - // subsequent Commit call completes successfully. + // LastStatement: Optional. If set to `true`, this statement marks the end of + // the transaction. After this statement executes, you must commit or abort the + // transaction. Attempts to execute any other requests against this transaction + // (including reads and queries) are rejected. For DML statements, setting this + // option might cause some error reporting to be deferred until commit time + // (for example, validation of unique constraints). Given this, successful + // execution of a DML statement shouldn't be assumed until a subsequent + // `Commit` call completes successfully. LastStatement bool `json:"lastStatement,omitempty"` - // ParamTypes: It is not always possible for Cloud Spanner to infer the right + // ParamTypes: It isn't always possible for Cloud Spanner to infer the right // SQL type from a JSON value. For example, values of type `BYTES` and values - // of type `STRING` both appear in params as JSON strings. In these cases, - // `param_types` can be used to specify the exact SQL type for some or all of - // the SQL statement parameters. See the definition of Type for more - // information about SQL types. + // of type `STRING` both appear in params as JSON strings. In these cases, you + // can use `param_types` to specify the exact SQL type for some or all of the + // SQL statement parameters. See the definition of Type for more information + // about SQL types. ParamTypes map[string]Type `json:"paramTypes,omitempty"` // Params: Parameter names and values that bind to placeholders in the SQL // string. A parameter placeholder consists of the `@` character followed by @@ -2558,13 +2558,13 @@ type ExecuteSqlRequest struct { // https://cloud.google.com/spanner/docs/lexical#identifiers. Parameters can // appear anywhere that a literal value is expected. The same parameter name // can be used more than once, for example: "WHERE id > @msg_id AND id < - // @msg_id + 100" It is an error to execute a SQL statement with unbound + // @msg_id + 100" It's an error to execute a SQL statement with unbound // parameters. Params googleapi.RawMessage `json:"params,omitempty"` - // PartitionToken: If present, results will be restricted to the specified - // partition previously created using PartitionQuery(). There must be an exact + // PartitionToken: If present, results are restricted to the specified + // partition previously created using `PartitionQuery`. There must be an exact // match for the values of fields common to this message and the - // PartitionQueryRequest message used to create this partition_token. + // `PartitionQueryRequest` message used to create this `partition_token`. PartitionToken string `json:"partitionToken,omitempty"` // QueryMode: Used to control the amount of debugging information returned in // ResultSetStats. If partition_token is set, query_mode can only be set to @@ -2576,8 +2576,8 @@ type ExecuteSqlRequest struct { // execution statistics information. // "PROFILE" - This mode returns the query plan, overall execution // statistics, operator level execution statistics along with the results. This - // has a performance overhead compared to the other modes. It is not - // recommended to use this mode for production traffic. + // has a performance overhead compared to the other modes. It isn't recommended + // to use this mode for production traffic. // "WITH_STATS" - This mode returns the overall (but not operator-level) // execution statistics along with the results. // "WITH_PLAN_AND_STATS" - This mode returns the query plan, overall (but not @@ -2596,11 +2596,11 @@ type ExecuteSqlRequest struct { ResumeToken string `json:"resumeToken,omitempty"` // Seqno: A per-transaction sequence number used to identify this request. This // field makes each request idempotent such that if the request is received - // multiple times, at most one will succeed. The sequence number must be + // multiple times, at most one succeeds. The sequence number must be // monotonically increasing within the transaction. If a request arrives for - // the first time with an out-of-order sequence number, the transaction may be - // aborted. Replays of previously handled requests will yield the same response - // as the first execution. Required for DML statements. Ignored for queries. + // the first time with an out-of-order sequence number, the transaction can be + // aborted. Replays of previously handled requests yield the same response as + // the first execution. Required for DML statements. Ignored for queries. Seqno int64 `json:"seqno,omitempty,string"` // Sql: Required. The SQL string. Sql string `json:"sql,omitempty"` @@ -2839,12 +2839,12 @@ func (s GetPolicyOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// IncludeReplicas: An IncludeReplicas contains a repeated set of -// ReplicaSelection which indicates the order in which replicas should be +// IncludeReplicas: An `IncludeReplicas` contains a repeated set of +// `ReplicaSelection` which indicates the order in which replicas should be // considered. type IncludeReplicas struct { - // AutoFailoverDisabled: If true, Spanner will not route requests to a replica - // outside the include_replicas list when all of the specified replicas are + // AutoFailoverDisabled: If `true`, Spanner doesn't route requests to a replica + // outside the <`include_replicas` list when all of the specified replicas are // unavailable or unhealthy. Default value is `false`. AutoFailoverDisabled bool `json:"autoFailoverDisabled,omitempty"` // ReplicaSelections: The directed read replica selector. @@ -4204,8 +4204,8 @@ func (s MoveInstanceRequest) MarshalJSON() ([]byte, error) { // MultiplexedSessionPrecommitToken: When a read-write transaction is executed // on a multiplexed session, this precommit token is sent back to the client as -// a part of the [Transaction] message in the BeginTransaction response and -// also as a part of the [ResultSet] and [PartialResultSet] responses. +// a part of the Transaction message in the BeginTransaction response and also +// as a part of the ResultSet and PartialResultSet responses. type MultiplexedSessionPrecommitToken struct { // PrecommitToken: Opaque precommit token. PrecommitToken string `json:"precommitToken,omitempty"` @@ -4413,13 +4413,17 @@ type PartialResultSet struct { // be combined with more values from subsequent `PartialResultSet`s to obtain a // complete field value. ChunkedValue bool `json:"chunkedValue,omitempty"` + // Last: Optional. Indicates whether this is the last `PartialResultSet` in the + // stream. The server might optionally set this field. Clients shouldn't rely + // on this field being set in all cases. + Last bool `json:"last,omitempty"` // Metadata: Metadata about the result set, such as row type information. Only // present in the first response. Metadata *ResultSetMetadata `json:"metadata,omitempty"` - // PrecommitToken: Optional. A precommit token will be included if the - // read-write transaction is on a multiplexed session. The precommit token with - // the highest sequence number from this transaction attempt should be passed - // to the Commit request for this transaction. + // PrecommitToken: Optional. A precommit token is included if the read-write + // transaction has multiplexed sessions enabled. Pass the precommit token with + // the highest sequence number from this transaction attempt to the Commit + // request for this transaction. PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // ResumeToken: Streaming calls might be interrupted for a variety of reasons, // such as TCP connection loss. If this occurs, the stream of results can be @@ -4430,46 +4434,45 @@ type PartialResultSet struct { // Stats: Query plan and execution statistics for the statement that produced // this streaming result set. These can be requested by setting // ExecuteSqlRequest.query_mode and are sent only once with the last response - // in the stream. This field will also be present in the last response for DML + // in the stream. This field is also present in the last response for DML // statements. Stats *ResultSetStats `json:"stats,omitempty"` // Values: A streamed result set consists of a stream of values, which might be // split into many `PartialResultSet` messages to accommodate large rows and/or // large values. Every N complete values defines a row, where N is equal to the // number of entries in metadata.row_type.fields. Most values are encoded based - // on type as described here. It is possible that the last value in values is + // on type as described here. It's possible that the last value in values is // "chunked", meaning that the rest of the value is sent in subsequent // `PartialResultSet`(s). This is denoted by the chunked_value field. Two or // more chunked values can be merged to form a complete value as follows: * - // `bool/number/null`: cannot be chunked * `string`: concatenate the strings * + // `bool/number/null`: can't be chunked * `string`: concatenate the strings * // `list`: concatenate the lists. If the last element in a list is a `string`, // `list`, or `object`, merge it with the first element in the next list by // applying these rules recursively. * `object`: concatenate the (field name, // field value) pairs. If a field name is duplicated, then apply these rules - // recursively to merge the field values. Some examples of merging: # Strings - // are concatenated. "foo", "bar" => "foobar" # Lists of non-strings are - // concatenated. [2, 3], [4] => [2, 3, 4] # Lists are concatenated, but the - // last and first elements are merged # because they are strings. ["a", "b"], - // ["c", "d"] => ["a", "bc", "d"] # Lists are concatenated, but the last and - // first elements are merged # because they are lists. Recursively, the last - // and first elements # of the inner lists are merged because they are strings. - // ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"] # Non-overlapping - // object fields are combined. {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"} # - // Overlapping object fields are merged. {"a": "1"}, {"a": "2"} => {"a": "12"} - // # Examples of merging objects containing lists of strings. {"a": ["1"]}, - // {"a": ["2"]} => {"a": ["12"]} For a more complete example, suppose a - // streaming SQL query is yielding a result set whose rows contain a single - // string field. The following `PartialResultSet`s might be yielded: { - // "metadata": { ... } "values": ["Hello", "W"] "chunked_value": true - // "resume_token": "Af65..." } { "values": ["orl"] "chunked_value": true } { - // "values": ["d"] "resume_token": "Zx1B..." } This sequence of - // `PartialResultSet`s encodes two rows, one containing the field value - // "Hello", and a second containing the field value "World" = "W" + "orl" + - // "d". Not all `PartialResultSet`s contain a `resume_token`. Execution can - // only be resumed from a previously yielded `resume_token`. For the above - // sequence of `PartialResultSet`s, resuming the query with "resume_token": - // "Af65..." will yield results from the `PartialResultSet` with value - // `["orl"]`. + // recursively to merge the field values. Some examples of merging: Strings are + // concatenated. "foo", "bar" => "foobar" Lists of non-strings are + // concatenated. [2, 3], [4] => [2, 3, 4] Lists are concatenated, but the last + // and first elements are merged because they are strings. ["a", "b"], ["c", + // "d"] => ["a", "bc", "d"] Lists are concatenated, but the last and first + // elements are merged because they are lists. Recursively, the last and first + // elements of the inner lists are merged because they are strings. ["a", ["b", + // "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"] Non-overlapping object fields + // are combined. {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"} Overlapping + // object fields are merged. {"a": "1"}, {"a": "2"} => {"a": "12"} Examples of + // merging objects containing lists of strings. {"a": ["1"]}, {"a": ["2"]} => + // {"a": ["12"]} For a more complete example, suppose a streaming SQL query is + // yielding a result set whose rows contain a single string field. The + // following `PartialResultSet`s might be yielded: { "metadata": { ... } + // "values": ["Hello", "W"] "chunked_value": true "resume_token": "Af65..." } { + // "values": ["orl"] "chunked_value": true } { "values": ["d"] "resume_token": + // "Zx1B..." } This sequence of `PartialResultSet`s encodes two rows, one + // containing the field value "Hello", and a second containing the field + // value "World" = "W" + "orl" + "d". Not all `PartialResultSet`s contain a + // `resume_token`. Execution can only be resumed from a previously yielded + // `resume_token`. For the above sequence of `PartialResultSet`s, resuming the + // query with "resume_token": "Af65..." yields results from the + // `PartialResultSet` with value "orl". Values []interface{} `json:"values,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -4495,9 +4498,9 @@ func (s PartialResultSet) MarshalJSON() ([]byte, error) { // Partition: Information returned for each partition returned in a // PartitionResponse. type Partition struct { - // PartitionToken: This token can be passed to Read, StreamingRead, ExecuteSql, - // or ExecuteStreamingSql requests to restrict the results to those identified - // by this partition token. + // PartitionToken: This token can be passed to `Read`, `StreamingRead`, + // `ExecuteSql`, or `ExecuteStreamingSql` requests to restrict the results to + // those identified by this partition token. PartitionToken string `json:"partitionToken,omitempty"` // ForceSendFields is a list of field names (e.g. "PartitionToken") to // unconditionally include in API requests. By default, fields with empty or @@ -4517,21 +4520,21 @@ func (s Partition) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PartitionOptions: Options for a PartitionQueryRequest and -// PartitionReadRequest. +// PartitionOptions: Options for a `PartitionQueryRequest` and +// `PartitionReadRequest`. type PartitionOptions struct { - // MaxPartitions: **Note:** This hint is currently ignored by PartitionQuery - // and PartitionRead requests. The desired maximum number of partitions to - // return. For example, this may be set to the number of workers available. The - // default for this option is currently 10,000. The maximum value is currently - // 200,000. This is only a hint. The actual number of partitions returned may - // be smaller or larger than this maximum count request. + // MaxPartitions: **Note:** This hint is currently ignored by `PartitionQuery` + // and `PartitionRead` requests. The desired maximum number of partitions to + // return. For example, this might be set to the number of workers available. + // The default for this option is currently 10,000. The maximum value is + // currently 200,000. This is only a hint. The actual number of partitions + // returned can be smaller or larger than this maximum count request. MaxPartitions int64 `json:"maxPartitions,omitempty,string"` // PartitionSizeBytes: **Note:** This hint is currently ignored by - // PartitionQuery and PartitionRead requests. The desired data size for each - // partition generated. The default for this option is currently 1 GiB. This is - // only a hint. The actual size of each partition may be smaller or larger than - // this size request. + // `PartitionQuery` and `PartitionRead` requests. The desired data size for + // each partition generated. The default for this option is currently 1 GiB. + // This is only a hint. The actual size of each partition can be smaller or + // larger than this size request. PartitionSizeBytes int64 `json:"partitionSizeBytes,omitempty,string"` // ForceSendFields is a list of field names (e.g. "MaxPartitions") to // unconditionally include in API requests. By default, fields with empty or @@ -4553,7 +4556,7 @@ func (s PartitionOptions) MarshalJSON() ([]byte, error) { // PartitionQueryRequest: The request for PartitionQuery type PartitionQueryRequest struct { - // ParamTypes: It is not always possible for Cloud Spanner to infer the right + // ParamTypes: It isn't always possible for Cloud Spanner to infer the right // SQL type from a JSON value. For example, values of type `BYTES` and values // of type `STRING` both appear in params as JSON strings. In these cases, // `param_types` can be used to specify the exact SQL type for some or all of @@ -4565,25 +4568,25 @@ type PartitionQueryRequest struct { // the parameter name (for example, `@firstName`). Parameter names can contain // letters, numbers, and underscores. Parameters can appear anywhere that a // literal value is expected. The same parameter name can be used more than - // once, for example: "WHERE id > @msg_id AND id < @msg_id + 100" It is an + // once, for example: "WHERE id > @msg_id AND id < @msg_id + 100" It's an // error to execute a SQL statement with unbound parameters. Params googleapi.RawMessage `json:"params,omitempty"` // PartitionOptions: Additional options that affect how many partitions are // created. PartitionOptions *PartitionOptions `json:"partitionOptions,omitempty"` // Sql: Required. The query request to generate partitions for. The request - // fails if the query is not root partitionable. For a query to be root + // fails if the query isn't root partitionable. For a query to be root // partitionable, it needs to satisfy a few conditions. For example, if the // query execution plan contains a distributed union operator, then it must be // the first operator in the plan. For more information about other conditions, // see Read data in parallel // (https://cloud.google.com/spanner/docs/reads#read_data_in_parallel). The // query request must not contain DML commands, such as `INSERT`, `UPDATE`, or - // `DELETE`. Use `ExecuteStreamingSql` with a PartitionedDml transaction for + // `DELETE`. Use `ExecuteStreamingSql` with a `PartitionedDml` transaction for // large, partition-friendly DML operations. Sql string `json:"sql,omitempty"` - // Transaction: Read only snapshot transactions are supported, read/write and - // single use transactions are not. + // Transaction: Read-only snapshot transactions are supported, read and write + // and single-use transactions are not. Transaction *TransactionSelector `json:"transaction,omitempty"` // ForceSendFields is a list of field names (e.g. "ParamTypes") to // unconditionally include in API requests. By default, fields with empty or @@ -4615,8 +4618,8 @@ type PartitionReadRequest struct { // KeySet: Required. `key_set` identifies the rows to be yielded. `key_set` // names the primary keys of the rows in table to be yielded, unless index is // present. If index is present, then key_set instead names index keys in - // index. It is not an error for the `key_set` to name rows that do not exist - // in the database. Read yields nothing for nonexistent rows. + // index. It isn't an error for the `key_set` to name rows that don't exist in + // the database. Read yields nothing for nonexistent rows. KeySet *KeySet `json:"keySet,omitempty"` // PartitionOptions: Additional options that affect how many partitions are // created. @@ -4887,14 +4890,14 @@ type QueryOptions struct { // different query optimizer statistics package. Specifying `latest` as a value // instructs Cloud Spanner to use the latest generated statistics package. If // not specified, Cloud Spanner uses the statistics package set at the database - // level options, or the latest package if the database option is not set. The + // level options, or the latest package if the database option isn't set. The // statistics package requested by the query has to be exempt from garbage - // collection. This can be achieved with the following DDL statement: ``` ALTER - // STATISTICS SET OPTIONS (allow_gc=false) ``` The list of available statistics - // packages can be queried from `INFORMATION_SCHEMA.SPANNER_STATISTICS`. - // Executing a SQL statement with an invalid optimizer statistics package or - // with a statistics package that allows garbage collection fails with an - // `INVALID_ARGUMENT` error. + // collection. This can be achieved with the following DDL statement: ```sql + // ALTER STATISTICS SET OPTIONS (allow_gc=false) ``` The list of available + // statistics packages can be queried from + // `INFORMATION_SCHEMA.SPANNER_STATISTICS`. Executing a SQL statement with an + // invalid optimizer statistics package or with a statistics package that + // allows garbage collection fails with an `INVALID_ARGUMENT` error. OptimizerStatisticsPackage string `json:"optimizerStatisticsPackage,omitempty"` // OptimizerVersion: An option to control the selection of optimizer version. // This parameter allows individual queries to pick different query optimizer @@ -4904,8 +4907,8 @@ type QueryOptions struct { // positive integer (from the list of supported optimizer versions) overrides // the default optimizer version for query execution. The list of supported // optimizer versions can be queried from - // SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement with an - // invalid optimizer version fails with an `INVALID_ARGUMENT` error. See + // `SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS`. Executing a SQL statement with + // an invalid optimizer version fails with an `INVALID_ARGUMENT` error. See // https://cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer // for more information on managing the query optimizer. The // `optimizer_version` statement hint has precedence over this setting. @@ -5083,7 +5086,7 @@ type ReadRequest struct { Columns []string `json:"columns,omitempty"` // DataBoostEnabled: If this is for a partitioned read and this field is set to // `true`, the request is executed with Spanner Data Boost independent compute - // resources. If the field is set to `true` but the request does not set + // resources. If the field is set to `true` but the request doesn't set // `partition_token`, the API returns an `INVALID_ARGUMENT` error. DataBoostEnabled bool `json:"dataBoostEnabled,omitempty"` // DirectedReadOptions: Directed read options for this request. @@ -5097,20 +5100,20 @@ type ReadRequest struct { // present. If index is present, then key_set instead names index keys in // index. If the partition_token field is empty, rows are yielded in table // primary key order (if index is empty) or index key order (if index is - // non-empty). If the partition_token field is not empty, rows will be yielded - // in an unspecified order. It is not an error for the `key_set` to name rows - // that do not exist in the database. Read yields nothing for nonexistent rows. + // non-empty). If the partition_token field isn't empty, rows are yielded in an + // unspecified order. It isn't an error for the `key_set` to name rows that + // don't exist in the database. Read yields nothing for nonexistent rows. KeySet *KeySet `json:"keySet,omitempty"` // Limit: If greater than zero, only the first `limit` rows are yielded. If - // `limit` is zero, the default is no limit. A limit cannot be specified if + // `limit` is zero, the default is no limit. A limit can't be specified if // `partition_token` is set. Limit int64 `json:"limit,omitempty,string"` // LockHint: Optional. Lock Hint for the request, it can only be used with // read-write transactions. // // Possible values: - // "LOCK_HINT_UNSPECIFIED" - Default value. LOCK_HINT_UNSPECIFIED is - // equivalent to LOCK_HINT_SHARED. + // "LOCK_HINT_UNSPECIFIED" - Default value. `LOCK_HINT_UNSPECIFIED` is + // equivalent to `LOCK_HINT_SHARED`. // "LOCK_HINT_SHARED" - Acquire shared locks. By default when you perform a // read as part of a read-write transaction, Spanner acquires shared read // locks, which allows other reads to still access the data until your @@ -5134,8 +5137,8 @@ type ReadRequest struct { // multiple transactions try to act on the same data, they automatically get // serialized. Each transaction waits its turn to acquire the lock and avoids // getting into deadlock situations. Because the exclusive lock hint is just a - // hint, it should not be considered equivalent to a mutex. In other words, you - // should not use Spanner exclusive locks as a mutual exclusion mechanism for + // hint, it shouldn't be considered equivalent to a mutex. In other words, you + // shouldn't use Spanner exclusive locks as a mutual exclusion mechanism for // the execution of code outside of Spanner. **Note:** Request exclusive locks // judiciously because they block others from reading that data for the entire // transaction, rather than just when the writes are being performed. Unless @@ -5143,23 +5146,23 @@ type ReadRequest struct { // locks so you don't prematurely block other clients from reading the data // that you're writing to. LockHint string `json:"lockHint,omitempty"` - // OrderBy: Optional. Order for the returned rows. By default, Spanner will - // return result rows in primary key order except for PartitionRead requests. - // For applications that do not require rows to be returned in primary key + // OrderBy: Optional. Order for the returned rows. By default, Spanner returns + // result rows in primary key order except for PartitionRead requests. For + // applications that don't require rows to be returned in primary key // (`ORDER_BY_PRIMARY_KEY`) order, setting `ORDER_BY_NO_ORDER` option allows // Spanner to optimize row retrieval, resulting in lower latencies in certain - // cases (e.g. bulk point lookups). + // cases (for example, bulk point lookups). // // Possible values: - // "ORDER_BY_UNSPECIFIED" - Default value. ORDER_BY_UNSPECIFIED is equivalent - // to ORDER_BY_PRIMARY_KEY. + // "ORDER_BY_UNSPECIFIED" - Default value. `ORDER_BY_UNSPECIFIED` is + // equivalent to `ORDER_BY_PRIMARY_KEY`. // "ORDER_BY_PRIMARY_KEY" - Read rows are returned in primary key order. In // the event that this option is used in conjunction with the `partition_token` - // field, the API will return an `INVALID_ARGUMENT` error. + // field, the API returns an `INVALID_ARGUMENT` error. // "ORDER_BY_NO_ORDER" - Read rows are returned in any order. OrderBy string `json:"orderBy,omitempty"` - // PartitionToken: If present, results will be restricted to the specified - // partition previously created using PartitionRead(). There must be an exact + // PartitionToken: If present, results are restricted to the specified + // partition previously created using `PartitionRead`. There must be an exact // match for the values of fields common to this message and the // PartitionReadRequest message used to create this partition_token. PartitionToken string `json:"partitionToken,omitempty"` @@ -5204,14 +5207,22 @@ type ReadWrite struct { // ReadLockMode: Read lock mode for the transaction. // // Possible values: - // "READ_LOCK_MODE_UNSPECIFIED" - Default value. If the value is not - // specified, the pessimistic read lock is used. + // "READ_LOCK_MODE_UNSPECIFIED" - Default value. * If isolation level is + // REPEATABLE_READ, then it is an error to specify `read_lock_mode`. Locking + // semantics default to `OPTIMISTIC`. No validation checks are done for reads, + // except to validate that the data that was served at the snapshot time is + // unchanged at commit time in the following cases: 1. reads done as part of + // queries that use `SELECT FOR UPDATE` 2. reads done as part of statements + // with a `LOCK_SCANNED_RANGES` hint 3. reads done as part of DML statements * + // At all other isolation levels, if `read_lock_mode` is the default value, + // then pessimistic read locks are used. // "PESSIMISTIC" - Pessimistic lock mode. Read locks are acquired immediately - // on read. + // on read. Semantics described only applies to SERIALIZABLE isolation. // "OPTIMISTIC" - Optimistic lock mode. Locks for reads within the // transaction are not acquired on read. Instead the locks are acquired on a // commit to validate that read/queried data has not changed since the - // transaction started. + // transaction started. Semantics described only applies to SERIALIZABLE + // isolation. ReadLockMode string `json:"readLockMode,omitempty"` // ForceSendFields is a list of field names (e.g. // "MultiplexedSessionPreviousTransactionId") to unconditionally include in API @@ -5313,13 +5324,14 @@ func (s ReplicaInfo) MarshalJSON() ([]byte, error) { // The location must be one of the regions within the multi-region // configuration of your database. * `type` - The type of the replica. Some // examples of using replica_selectors are: * `location:us-east1` --> The -// "us-east1" replica(s) of any available type will be used to process the -// request. * `type:READ_ONLY` --> The "READ_ONLY" type replica(s) in nearest -// available location will be used to process the request. * `location:us-east1 +// "us-east1" replica(s) of any available type is used to process the request. +// * `type:READ_ONLY` --> The "READ_ONLY" type replica(s) in the nearest +// available location are used to process the request. * `location:us-east1 // type:READ_ONLY` --> The "READ_ONLY" type replica(s) in location "us-east1" -// will be used to process the request. +// is used to process the request. type ReplicaSelection struct { - // Location: The location or region of the serving requests, e.g. "us-east1". + // Location: The location or region of the serving requests, for example, + // "us-east1". Location string `json:"location,omitempty"` // Type: The type of replica. // @@ -5358,23 +5370,23 @@ type RequestOptions struct { // "PRIORITY_HIGH" - This specifies that the request is high priority. Priority string `json:"priority,omitempty"` // RequestTag: A per-request tag which can be applied to queries or reads, used - // for statistics collection. Both request_tag and transaction_tag can be + // for statistics collection. Both `request_tag` and `transaction_tag` can be // specified for a read or query that belongs to a transaction. This field is - // ignored for requests where it's not applicable (e.g. CommitRequest). Legal - // characters for `request_tag` values are all printable characters (ASCII 32 - - // 126) and the length of a request_tag is limited to 50 characters. Values - // that exceed this limit are truncated. Any leading underscore (_) characters - // will be removed from the string. + // ignored for requests where it's not applicable (for example, + // `CommitRequest`). Legal characters for `request_tag` values are all + // printable characters (ASCII 32 - 126) and the length of a request_tag is + // limited to 50 characters. Values that exceed this limit are truncated. Any + // leading underscore (_) characters are removed from the string. RequestTag string `json:"requestTag,omitempty"` // TransactionTag: A tag used for statistics collection about this transaction. - // Both request_tag and transaction_tag can be specified for a read or query - // that belongs to a transaction. The value of transaction_tag should be the - // same for all requests belonging to the same transaction. If this request - // doesn't belong to any transaction, transaction_tag will be ignored. Legal + // Both `request_tag` and `transaction_tag` can be specified for a read or + // query that belongs to a transaction. The value of transaction_tag should be + // the same for all requests belonging to the same transaction. If this request + // doesn't belong to any transaction, `transaction_tag` is ignored. Legal // characters for `transaction_tag` values are all printable characters (ASCII - // 32 - 126) and the length of a transaction_tag is limited to 50 characters. + // 32 - 126) and the length of a `transaction_tag` is limited to 50 characters. // Values that exceed this limit are truncated. Any leading underscore (_) - // characters will be removed from the string. + // characters are removed from the string. TransactionTag string `json:"transactionTag,omitempty"` // ForceSendFields is a list of field names (e.g. "Priority") to // unconditionally include in API requests. By default, fields with empty or @@ -5564,10 +5576,10 @@ func (s RestoreInfo) MarshalJSON() ([]byte, error) { type ResultSet struct { // Metadata: Metadata about the result set, such as row type information. Metadata *ResultSetMetadata `json:"metadata,omitempty"` - // PrecommitToken: Optional. A precommit token will be included if the - // read-write transaction is on a multiplexed session. The precommit token with - // the highest sequence number from this transaction attempt should be passed - // to the Commit request for this transaction. + // PrecommitToken: Optional. A precommit token is included if the read-write + // transaction is on a multiplexed session. Pass the precommit token with the + // highest sequence number from this transaction attempt to the Commit request + // for this transaction. PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // Rows: Each element in `rows` is a row whose format is defined by // metadata.row_type. The ith element in each row matches the ith field in @@ -5578,7 +5590,7 @@ type ResultSet struct { // ExecuteSqlRequest.query_mode. DML statements always produce stats containing // the number of rows modified, unless executed using the // ExecuteSqlRequest.QueryMode.PLAN ExecuteSqlRequest.query_mode. Other fields - // may or may not be populated, based on the ExecuteSqlRequest.query_mode. + // might or might not be populated, based on the ExecuteSqlRequest.query_mode. Stats *ResultSetStats `json:"stats,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -5649,8 +5661,8 @@ type ResultSetStats struct { // RowCountExact: Standard DML returns an exact count of rows that were // modified. RowCountExact int64 `json:"rowCountExact,omitempty,string"` - // RowCountLowerBound: Partitioned DML does not offer exactly-once semantics, - // so it returns a lower bound of the rows modified. + // RowCountLowerBound: Partitioned DML doesn't offer exactly-once semantics, so + // it returns a lower bound of the rows modified. RowCountLowerBound int64 `json:"rowCountLowerBound,omitempty,string"` // ForceSendFields is a list of field names (e.g. "QueryPlan") to // unconditionally include in API requests. By default, fields with empty or @@ -5762,7 +5774,7 @@ func (s ScanData) MarshalJSON() ([]byte, error) { // Session: A session in the Cloud Spanner API. type Session struct { // ApproximateLastUseTime: Output only. The approximate timestamp when the - // session is last used. It is typically earlier than the actual last use time. + // session is last used. It's typically earlier than the actual last use time. ApproximateLastUseTime string `json:"approximateLastUseTime,omitempty"` // CreateTime: Output only. The timestamp when the session is created. CreateTime string `json:"createTime,omitempty"` @@ -5776,7 +5788,7 @@ type Session struct { // with a given session. See https://goo.gl/xmQnxf for more information on and // examples of labels. Labels map[string]string `json:"labels,omitempty"` - // Multiplexed: Optional. If true, specifies a multiplexed session. Use a + // Multiplexed: Optional. If `true`, specifies a multiplexed session. Use a // multiplexed session for multiple, concurrent read-only operations. Don't use // them for read-write transactions, partitioned reads, or partitioned queries. // Use `sessions.create` to create multiplexed sessions. Don't use @@ -5920,7 +5932,7 @@ func (s SplitPoints) MarshalJSON() ([]byte, error) { // Statement: A single DML statement. type Statement struct { - // ParamTypes: It is not always possible for Cloud Spanner to infer the right + // ParamTypes: It isn't always possible for Cloud Spanner to infer the right // SQL type from a JSON value. For example, values of type `BYTES` and values // of type `STRING` both appear in params as JSON strings. In these cases, // `param_types` can be used to specify the exact SQL type for some or all of @@ -5932,7 +5944,7 @@ type Statement struct { // the parameter name (for example, `@firstName`). Parameter names can contain // letters, numbers, and underscores. Parameters can appear anywhere that a // literal value is expected. The same parameter name can be used more than - // once, for example: "WHERE id > @msg_id AND id < @msg_id + 100" It is an + // once, for example: "WHERE id > @msg_id AND id < @msg_id + 100" It's an // error to execute a SQL statement with unbound parameters. Params googleapi.RawMessage `json:"params,omitempty"` // Sql: Required. The DML string. @@ -6319,6 +6331,28 @@ type TransactionOptions struct { // partitioned-dml transactions, otherwise the API will return an // `INVALID_ARGUMENT` error. ExcludeTxnFromChangeStreams bool `json:"excludeTxnFromChangeStreams,omitempty"` + // IsolationLevel: Isolation level for the transaction. + // + // Possible values: + // "ISOLATION_LEVEL_UNSPECIFIED" - Default value. If the value is not + // specified, the `SERIALIZABLE` isolation level is used. + // "SERIALIZABLE" - All transactions appear as if they executed in a serial + // order, even if some of the reads, writes, and other operations of distinct + // transactions actually occurred in parallel. Spanner assigns commit + // timestamps that reflect the order of committed transactions to implement + // this property. Spanner offers a stronger guarantee than serializability + // called external consistency. For further details, please refer to + // https://cloud.google.com/spanner/docs/true-time-external-consistency#serializability. + // "REPEATABLE_READ" - All reads performed during the transaction observe a + // consistent snapshot of the database, and the transaction will only + // successfully commit in the absence of conflicts between its updates and any + // concurrent updates that have occurred since that snapshot. Consequently, in + // contrast to `SERIALIZABLE` transactions, only write-write conflicts are + // detected in snapshot transactions. This isolation level does not support + // Read-only and Partitioned DML transactions. When `REPEATABLE_READ` is + // specified on a read-write transaction, the locking semantics default to + // `OPTIMISTIC`. + IsolationLevel string `json:"isolationLevel,omitempty"` // PartitionedDml: Partitioned DML transaction. Authorization to begin a // Partitioned DML transaction requires // `spanner.databases.beginPartitionedDmlTransaction` permission on the @@ -15358,15 +15392,16 @@ type ProjectsInstancesDatabasesSessionsBatchWriteCall struct { // efficient transactions. All mutations in a group are committed atomically. // However, mutations across groups can be committed non-atomically in an // unspecified order and thus, they must be independent of each other. Partial -// failure is possible, i.e., some groups may have been committed successfully, -// while some may have failed. The results of individual batches are streamed -// into the response as the batches are applied. BatchWrite requests are not -// replay protected, meaning that each mutation group may be applied more than -// once. Replays of non-idempotent mutations may have undesirable effects. For -// example, replays of an insert mutation may produce an already exists error -// or if you use generated or commit timestamp-based keys, it may result in -// additional rows being added to the mutation's table. We recommend -// structuring your mutation groups to be idempotent to avoid this issue. +// failure is possible, that is, some groups might have been committed +// successfully, while some might have failed. The results of individual +// batches are streamed into the response as the batches are applied. +// `BatchWrite` requests are not replay protected, meaning that each mutation +// group can be applied more than once. Replays of non-idempotent mutations can +// have undesirable effects. For example, replays of an insert mutation can +// produce an already exists error or if you use generated or commit +// timestamp-based keys, it can result in additional rows being added to the +// mutation's table. We recommend structuring your mutation groups to be +// idempotent to avoid this issue. // // - session: The session in which the batch request is to be run. func (r *ProjectsInstancesDatabasesSessionsService) BatchWrite(session string, batchwriterequest *BatchWriteRequest) *ProjectsInstancesDatabasesSessionsBatchWriteCall { @@ -15578,11 +15613,11 @@ type ProjectsInstancesDatabasesSessionsCommitCall struct { // applied to rows in the database. `Commit` might return an `ABORTED` error. // This can occur at any time; commonly, the cause is conflicts with concurrent // transactions. However, it can also happen for a variety of other reasons. If -// `Commit` returns `ABORTED`, the caller should re-attempt the transaction -// from the beginning, re-using the same session. On very rare occasions, -// `Commit` might return `UNKNOWN`. This can happen, for example, if the client -// job experiences a 1+ hour networking failure. At that point, Cloud Spanner -// has lost track of the transaction outcome and we recommend that you perform +// `Commit` returns `ABORTED`, the caller should retry the transaction from the +// beginning, reusing the same session. On very rare occasions, `Commit` might +// return `UNKNOWN`. This can happen, for example, if the client job +// experiences a 1+ hour networking failure. At that point, Cloud Spanner has +// lost track of the transaction outcome and we recommend that you perform // another read from the database to see the state of things as they are now. // // - session: The session in which the transaction to be committed is running. @@ -15693,11 +15728,11 @@ type ProjectsInstancesDatabasesSessionsCreateCall struct { // read-write/write-only transactions, create multiple sessions. Note that // standalone reads and queries use a transaction internally, and count toward // the one transaction limit. Active sessions use additional server resources, -// so it is a good idea to delete idle and unneeded sessions. Aside from -// explicit deletes, Cloud Spanner may delete sessions for which no operations -// are sent for more than an hour. If a session is deleted, requests to it -// return `NOT_FOUND`. Idle sessions can be kept alive by sending a trivial SQL -// query periodically, e.g., "SELECT 1". +// so it's a good idea to delete idle and unneeded sessions. Aside from +// explicit deletes, Cloud Spanner can delete sessions when no operations are +// sent for more than an hour. If a session is deleted, requests to it return +// `NOT_FOUND`. Idle sessions can be kept alive by sending a trivial SQL query +// periodically, for example, "SELECT 1". // // - database: The database in which the new session is created. func (r *ProjectsInstancesDatabasesSessionsService) Create(database string, createsessionrequest *CreateSessionRequest) *ProjectsInstancesDatabasesSessionsCreateCall { @@ -15800,7 +15835,7 @@ type ProjectsInstancesDatabasesSessionsDeleteCall struct { } // Delete: Ends a session, releasing server resources associated with it. This -// will asynchronously trigger cancellation of any operations that are running +// asynchronously triggers the cancellation of any operations that are running // with this session. // // - name: The name of the session to delete. @@ -16011,7 +16046,7 @@ type ProjectsInstancesDatabasesSessionsExecuteSqlCall struct { } // ExecuteSql: Executes an SQL statement, returning all results in a single -// reply. This method cannot be used to return a result set larger than 10 MiB; +// reply. This method can't be used to return a result set larger than 10 MiB; // if the query yields more data than that, the query fails with a // `FAILED_PRECONDITION` error. Operations inside read-write transactions might // return `ABORTED`. If this occurs, the application should restart the @@ -16231,7 +16266,7 @@ type ProjectsInstancesDatabasesSessionsGetCall struct { header_ http.Header } -// Get: Gets a session. Returns `NOT_FOUND` if the session does not exist. This +// Get: Gets a session. Returns `NOT_FOUND` if the session doesn't exist. This // is mainly useful for determining whether a session is still alive. // // - name: The name of the session to retrieve. @@ -16503,11 +16538,11 @@ type ProjectsInstancesDatabasesSessionsPartitionQueryCall struct { // execute a query operation in parallel. Each of the returned partition tokens // can be used by ExecuteStreamingSql to specify a subset of the query result // to read. The same session and read-only transaction must be used by the -// PartitionQueryRequest used to create the partition tokens and the -// ExecuteSqlRequests that use the partition tokens. Partition tokens become +// `PartitionQueryRequest` used to create the partition tokens and the +// `ExecuteSqlRequests` that use the partition tokens. Partition tokens become // invalid when the session used to create them is deleted, is idle for too // long, begins a new transaction, or becomes too old. When any of these -// happen, it is not possible to resume the query, and the whole operation must +// happen, it isn't possible to resume the query, and the whole operation must // be restarted from the beginning. // // - session: The session used to create the partitions. @@ -16616,14 +16651,14 @@ type ProjectsInstancesDatabasesSessionsPartitionReadCall struct { // a read operation in parallel. Each of the returned partition tokens can be // used by StreamingRead to specify a subset of the read result to read. The // same session and read-only transaction must be used by the -// PartitionReadRequest used to create the partition tokens and the -// ReadRequests that use the partition tokens. There are no ordering guarantees -// on rows returned among the returned partition tokens, or even within each -// individual StreamingRead call issued with a partition_token. Partition -// tokens become invalid when the session used to create them is deleted, is -// idle for too long, begins a new transaction, or becomes too old. When any of -// these happen, it is not possible to resume the read, and the whole operation -// must be restarted from the beginning. +// `PartitionReadRequest` used to create the partition tokens and the +// `ReadRequests` that use the partition tokens. There are no ordering +// guarantees on rows returned among the returned partition tokens, or even +// within each individual `StreamingRead` call issued with a `partition_token`. +// Partition tokens become invalid when the session used to create them is +// deleted, is idle for too long, begins a new transaction, or becomes too old. +// When any of these happen, it isn't possible to resume the read, and the +// whole operation must be restarted from the beginning. // // - session: The session used to create the partitions. func (r *ProjectsInstancesDatabasesSessionsService) PartitionRead(session string, partitionreadrequest *PartitionReadRequest) *ProjectsInstancesDatabasesSessionsPartitionReadCall { @@ -16728,7 +16763,7 @@ type ProjectsInstancesDatabasesSessionsReadCall struct { } // Read: Reads rows from the database using key lookups and scans, as a simple -// key/value style alternative to ExecuteSql. This method cannot be used to +// key/value style alternative to ExecuteSql. This method can't be used to // return a result set larger than 10 MiB; if the read matches more data than // that, the read fails with a `FAILED_PRECONDITION` error. Reads inside // read-write transactions might return `ABORTED`. If this occurs, the @@ -16837,12 +16872,11 @@ type ProjectsInstancesDatabasesSessionsRollbackCall struct { header_ http.Header } -// Rollback: Rolls back a transaction, releasing any locks it holds. It is a +// Rollback: Rolls back a transaction, releasing any locks it holds. It's a // good idea to call this for any transaction that includes one or more Read or // ExecuteSql requests and ultimately decides not to commit. `Rollback` returns // `OK` if it successfully aborts the transaction, the transaction was already -// aborted, or the transaction is not found. `Rollback` never returns -// `ABORTED`. +// aborted, or the transaction isn't found. `Rollback` never returns `ABORTED`. // // - session: The session in which the transaction to roll back is running. func (r *ProjectsInstancesDatabasesSessionsService) Rollback(session string, rollbackrequest *RollbackRequest) *ProjectsInstancesDatabasesSessionsRollbackCall { diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json index 8329969447..d54b0ee049 100644 --- a/sqladmin/v1/sqladmin-api.json +++ b/sqladmin/v1/sqladmin-api.json @@ -755,6 +755,21 @@ "description": "Database type and version you want to retrieve flags for. By default, this method returns flags for all database types and versions.", "location": "query", "type": "string" + }, + "flagScope": { + "description": "Optional. Specify the scope of flags to be returned by SqlFlagsListService. Return list of database flags if unspecified.", + "enum": [ + "SQL_FLAG_SCOPE_UNSPECIFIED", + "SQL_FLAG_SCOPE_DATABASE", + "SQL_FLAG_SCOPE_CONNECTION_POOL" + ], + "enumDescriptions": [ + "Assume database flags if unspecified", + "database flags", + "connection pool configuration flags" + ], + "location": "query", + "type": "string" } }, "path": "v1/flags", @@ -2550,7 +2565,7 @@ } } }, - "revision": "20250226", + "revision": "20250310", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2694,6 +2709,155 @@ "readOnly": true, "type": "string" }, + "databaseVersion": { + "description": "Output only. The database version of the instance of when this backup was made.", + "enum": [ + "SQL_DATABASE_VERSION_UNSPECIFIED", + "MYSQL_5_1", + "MYSQL_5_5", + "MYSQL_5_6", + "MYSQL_5_7", + "MYSQL_8_0", + "MYSQL_8_0_18", + "MYSQL_8_0_26", + "MYSQL_8_0_27", + "MYSQL_8_0_28", + "MYSQL_8_0_29", + "MYSQL_8_0_30", + "MYSQL_8_0_31", + "MYSQL_8_0_32", + "MYSQL_8_0_33", + "MYSQL_8_0_34", + "MYSQL_8_0_35", + "MYSQL_8_0_36", + "MYSQL_8_0_37", + "MYSQL_8_0_38", + "MYSQL_8_0_39", + "MYSQL_8_0_40", + "MYSQL_8_0_41", + "MYSQL_8_0_42", + "MYSQL_8_4", + "SQLSERVER_2017_STANDARD", + "SQLSERVER_2017_ENTERPRISE", + "SQLSERVER_2017_EXPRESS", + "SQLSERVER_2017_WEB", + "POSTGRES_9_6", + "POSTGRES_10", + "POSTGRES_11", + "POSTGRES_12", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16", + "POSTGRES_17", + "SQLSERVER_2019_STANDARD", + "SQLSERVER_2019_ENTERPRISE", + "SQLSERVER_2019_EXPRESS", + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" + ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "The database version is MySQL 5.1.", + "The database version is MySQL 5.5.", + "The database version is MySQL 5.6.", + "The database version is MySQL 5.7.", + "The database version is MySQL 8.", + "The database major version is MySQL 8.0 and the minor version is 18.", + "The database major version is MySQL 8.0 and the minor version is 26.", + "The database major version is MySQL 8.0 and the minor version is 27.", + "The database major version is MySQL 8.0 and the minor version is 28.", + "The database major version is MySQL 8.0 and the minor version is 29.", + "The database major version is MySQL 8.0 and the minor version is 30.", + "The database major version is MySQL 8.0 and the minor version is 31.", + "The database major version is MySQL 8.0 and the minor version is 32.", + "The database major version is MySQL 8.0 and the minor version is 33.", + "The database major version is MySQL 8.0 and the minor version is 34.", + "The database major version is MySQL 8.0 and the minor version is 35.", + "The database major version is MySQL 8.0 and the minor version is 36.", + "The database major version is MySQL 8.0 and the minor version is 37.", + "The database major version is MySQL 8.0 and the minor version is 38.", + "The database major version is MySQL 8.0 and the minor version is 39.", + "The database major version is MySQL 8.0 and the minor version is 40.", + "The database major version is MySQL 8.0 and the minor version is 41.", + "The database major version is MySQL 8.0 and the minor version is 42.", + "The database version is MySQL 8.4.", + "The database version is SQL Server 2017 Standard.", + "The database version is SQL Server 2017 Enterprise.", + "The database version is SQL Server 2017 Express.", + "The database version is SQL Server 2017 Web.", + "The database version is PostgreSQL 9.6.", + "The database version is PostgreSQL 10.", + "The database version is PostgreSQL 11.", + "The database version is PostgreSQL 12.", + "The database version is PostgreSQL 13.", + "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", + "The database version is PostgreSQL 16.", + "The database version is PostgreSQL 17.", + "The database version is SQL Server 2019 Standard.", + "The database version is SQL Server 2019 Enterprise.", + "The database version is SQL Server 2019 Express.", + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." + ], + "readOnly": true, + "type": "string" + }, "description": { "description": "The description of this backup.", "type": "string" @@ -2972,6 +3136,155 @@ ], "type": "string" }, + "databaseVersion": { + "description": "Output only. The instance database version when this backup was made.", + "enum": [ + "SQL_DATABASE_VERSION_UNSPECIFIED", + "MYSQL_5_1", + "MYSQL_5_5", + "MYSQL_5_6", + "MYSQL_5_7", + "MYSQL_8_0", + "MYSQL_8_0_18", + "MYSQL_8_0_26", + "MYSQL_8_0_27", + "MYSQL_8_0_28", + "MYSQL_8_0_29", + "MYSQL_8_0_30", + "MYSQL_8_0_31", + "MYSQL_8_0_32", + "MYSQL_8_0_33", + "MYSQL_8_0_34", + "MYSQL_8_0_35", + "MYSQL_8_0_36", + "MYSQL_8_0_37", + "MYSQL_8_0_38", + "MYSQL_8_0_39", + "MYSQL_8_0_40", + "MYSQL_8_0_41", + "MYSQL_8_0_42", + "MYSQL_8_4", + "SQLSERVER_2017_STANDARD", + "SQLSERVER_2017_ENTERPRISE", + "SQLSERVER_2017_EXPRESS", + "SQLSERVER_2017_WEB", + "POSTGRES_9_6", + "POSTGRES_10", + "POSTGRES_11", + "POSTGRES_12", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16", + "POSTGRES_17", + "SQLSERVER_2019_STANDARD", + "SQLSERVER_2019_ENTERPRISE", + "SQLSERVER_2019_EXPRESS", + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" + ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "The database version is MySQL 5.1.", + "The database version is MySQL 5.5.", + "The database version is MySQL 5.6.", + "The database version is MySQL 5.7.", + "The database version is MySQL 8.", + "The database major version is MySQL 8.0 and the minor version is 18.", + "The database major version is MySQL 8.0 and the minor version is 26.", + "The database major version is MySQL 8.0 and the minor version is 27.", + "The database major version is MySQL 8.0 and the minor version is 28.", + "The database major version is MySQL 8.0 and the minor version is 29.", + "The database major version is MySQL 8.0 and the minor version is 30.", + "The database major version is MySQL 8.0 and the minor version is 31.", + "The database major version is MySQL 8.0 and the minor version is 32.", + "The database major version is MySQL 8.0 and the minor version is 33.", + "The database major version is MySQL 8.0 and the minor version is 34.", + "The database major version is MySQL 8.0 and the minor version is 35.", + "The database major version is MySQL 8.0 and the minor version is 36.", + "The database major version is MySQL 8.0 and the minor version is 37.", + "The database major version is MySQL 8.0 and the minor version is 38.", + "The database major version is MySQL 8.0 and the minor version is 39.", + "The database major version is MySQL 8.0 and the minor version is 40.", + "The database major version is MySQL 8.0 and the minor version is 41.", + "The database major version is MySQL 8.0 and the minor version is 42.", + "The database version is MySQL 8.4.", + "The database version is SQL Server 2017 Standard.", + "The database version is SQL Server 2017 Enterprise.", + "The database version is SQL Server 2017 Express.", + "The database version is SQL Server 2017 Web.", + "The database version is PostgreSQL 9.6.", + "The database version is PostgreSQL 10.", + "The database version is PostgreSQL 11.", + "The database version is PostgreSQL 12.", + "The database version is PostgreSQL 13.", + "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", + "The database version is PostgreSQL 16.", + "The database version is PostgreSQL 17.", + "The database version is SQL Server 2019 Standard.", + "The database version is SQL Server 2019 Enterprise.", + "The database version is SQL Server 2019 Express.", + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." + ], + "readOnly": true, + "type": "string" + }, "description": { "description": "The description of this run, only applicable to on-demand backups.", "type": "string" @@ -3174,6 +3487,39 @@ }, "type": "object" }, + "ConnectPoolNodeConfig": { + "description": "Details of a single node of a read pool.", + "id": "ConnectPoolNodeConfig", + "properties": { + "dnsName": { + "description": "Output only. The DNS name of the node.", + "readOnly": true, + "type": "string" + }, + "dnsNames": { + "description": "Output only. The list of DNS names used by this node.", + "items": { + "$ref": "DnsNameMapping" + }, + "readOnly": true, + "type": "array" + }, + "ipAddresses": { + "description": "Output only. Mappings containing IP addresses that can be used to connect to the node.", + "items": { + "$ref": "IpMapping" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The name of the node. Doesn't include the project ID.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ConnectSettings": { "description": "Connect settings retrieval response.", "id": "ConnectSettings", @@ -3378,6 +3724,19 @@ "description": "This is always `sql#connectSettings`.", "type": "string" }, + "nodeCount": { + "description": "The number of nodes in a read pool.", + "format": "int32", + "type": "integer" + }, + "nodes": { + "description": "Output only. Entries containing information about each node of the read pool.", + "items": { + "$ref": "ConnectPoolNodeConfig" + }, + "readOnly": true, + "type": "array" + }, "pscEnabled": { "description": "Whether PSC connectivity is enabled for this instance.", "type": "boolean" @@ -3409,6 +3768,84 @@ }, "type": "object" }, + "ConnectionPoolConfig": { + "description": "The managed connection pooling configuration.", + "id": "ConnectionPoolConfig", + "properties": { + "clientConnectionIdleTimeout": { + "deprecated": true, + "description": "Client idle timeout.", + "format": "google-duration", + "type": "string" + }, + "connPoolSize": { + "deprecated": true, + "description": "Managed connection pool size.", + "format": "int32", + "type": "integer" + }, + "connectionPoolingEnabled": { + "description": "Whether managed connection pooling is enabled.", + "type": "boolean" + }, + "flags": { + "description": "Optional. List of connection pool configuration flags", + "items": { + "$ref": "ConnectionPoolFlags" + }, + "type": "array" + }, + "maxClientConnections": { + "deprecated": true, + "description": "Maximum number of client connections in connection pool.", + "format": "int32", + "type": "integer" + }, + "poolMode": { + "deprecated": true, + "description": "The managed connection pool mode for the instance.", + "enum": [ + "POOL_MODE_UNSPECIFIED", + "SESSION", + "TRANSACTION" + ], + "enumDescriptions": [ + "The pool mode is unknown.", + "The session mode for managed connection pooling.", + "The transaction(default) mode for managed connection pooling." + ], + "type": "string" + }, + "queryWaitTimeout": { + "deprecated": true, + "description": "Query wait timeout.", + "format": "google-duration", + "type": "string" + }, + "serverConnectionIdleTimeout": { + "deprecated": true, + "description": "Server idle timeout.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, + "ConnectionPoolFlags": { + "description": "Connection pool flags for Cloud SQL instances managed connection pool configuration.", + "id": "ConnectionPoolFlags", + "properties": { + "name": { + "description": "Required. The name of the flag.", + "type": "string" + }, + "value": { + "description": "Required. The value of the flag. Boolean flags are set to `on` for true and `off` for false. This field must be omitted if the flag doesn't take a value.", + "type": "string" + } + }, + "type": "object" + }, "DataCacheConfig": { "description": "Data cache configurations.", "id": "DataCacheConfig", @@ -3737,13 +4174,15 @@ "SQL_INSTANCE_TYPE_UNSPECIFIED", "CLOUD_SQL_INSTANCE", "ON_PREMISES_INSTANCE", - "READ_REPLICA_INSTANCE" + "READ_REPLICA_INSTANCE", + "READ_POOL_INSTANCE" ], "enumDescriptions": [ "This is an unknown Cloud SQL instance type.", "A regular Cloud SQL instance that is not replicating from a primary instance.", "An instance running on the customer's premises that is not managed by Cloud SQL.", - "A Cloud SQL instance acting as a read-replica." + "A Cloud SQL instance acting as a read-replica.", + "CloudSQL read pool." ], "type": "string" }, @@ -3781,6 +4220,19 @@ "description": "Name of the Cloud SQL instance. This does not include the project ID.", "type": "string" }, + "nodeCount": { + "description": "The number of nodes in a read pool.", + "format": "int32", + "type": "integer" + }, + "nodes": { + "description": "Output only. Entries containing information about each node of the read pool.", + "items": { + "$ref": "PoolNodeConfig" + }, + "readOnly": true, + "type": "array" + }, "onPremisesConfiguration": { "$ref": "OnPremisesConfiguration", "description": "Configuration specific to on-premises instances." @@ -3883,7 +4335,8 @@ "PENDING_CREATE", "MAINTENANCE", "FAILED", - "ONLINE_MAINTENANCE" + "ONLINE_MAINTENANCE", + "REPAIRING" ], "enumDeprecated": [ false, @@ -3893,7 +4346,8 @@ false, false, false, - true + true, + false ], "enumDescriptions": [ "The state of the instance is unknown.", @@ -3903,7 +4357,8 @@ "The instance is being created.", "The instance is down for maintenance.", "The creation of the instance failed or a fatal error occurred during maintenance.", - "Deprecated" + "Deprecated", + "(Applicable to read pool nodes only.) The read pool node needs to be repaired. The database might be unavailable." ], "type": "string" }, @@ -4547,6 +5002,20 @@ }, "type": "array" }, + "flagScope": { + "description": "Scope of flag.", + "enum": [ + "SQL_FLAG_SCOPE_UNSPECIFIED", + "SQL_FLAG_SCOPE_DATABASE", + "SQL_FLAG_SCOPE_CONNECTION_POOL" + ], + "enumDescriptions": [ + "Assume database flags if unspecified", + "database flags", + "connection pool configuration flags" + ], + "type": "string" + }, "inBeta": { "description": "Whether or not the flag is considered in beta.", "type": "boolean" @@ -4569,6 +5038,15 @@ "description": "This is the name of the flag. Flag names always use underscores, not hyphens, for example: `max_allowed_packet`", "type": "string" }, + "recommendedIntValue": { + "description": "Recommended int value in integer format for UI display.", + "format": "int64", + "type": "string" + }, + "recommendedStringValue": { + "description": "Recommended string value in string format for UI display.", + "type": "string" + }, "requiresRestart": { "description": "Indicates whether changing this flag will trigger a database restart. Only applicable to Second Generation instances.", "type": "boolean" @@ -5596,7 +6074,9 @@ "MAJOR_VERSION_UPGRADE", "ADVANCED_BACKUP", "MANAGE_BACKUP", - "ENHANCED_BACKUP" + "ENHANCED_BACKUP", + "REPAIR_READ_POOL", + "CREATE_READ_POOL" ], "enumDeprecated": [ false, @@ -5648,6 +6128,8 @@ false, true, false, + false, + false, false ], "enumDescriptions": [ @@ -5700,7 +6182,9 @@ "Updates the major version of a Cloud SQL instance.", "Deprecated: ADVANCED_BACKUP is deprecated. Use ENHANCED_BACKUP instead.", "Changes the BackupTier of a Cloud SQL instance.", - "Creates a backup for an Enhanced BackupTier Cloud SQL instance." + "Creates a backup for an Enhanced BackupTier Cloud SQL instance.", + "Repairs entire read pool or specified nodes in the read pool.", + "Creates a Cloud SQL read pool instance." ], "type": "string" }, @@ -5929,6 +6413,82 @@ }, "type": "object" }, + "PoolNodeConfig": { + "description": "Details of a single node of a read pool.", + "id": "PoolNodeConfig", + "properties": { + "dnsName": { + "description": "Output only. The DNS name of the node.", + "readOnly": true, + "type": "string" + }, + "dnsNames": { + "description": "Output only. The list of DNS names used by this node.", + "items": { + "$ref": "DnsNameMapping" + }, + "readOnly": true, + "type": "array" + }, + "gceZone": { + "description": "Output only. The serving zone of the node.", + "readOnly": true, + "type": "string" + }, + "ipAddresses": { + "description": "Output only. Mappings containing IP addresses that can be used to connect to the node.", + "items": { + "$ref": "IpMapping" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The name of the node, to be used for retrieving metrics and logs for the node.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of the node.", + "enum": [ + "SQL_INSTANCE_STATE_UNSPECIFIED", + "RUNNABLE", + "SUSPENDED", + "PENDING_DELETE", + "PENDING_CREATE", + "MAINTENANCE", + "FAILED", + "ONLINE_MAINTENANCE", + "REPAIRING" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true, + false + ], + "enumDescriptions": [ + "The state of the instance is unknown.", + "The instance is running, or has been stopped by owner.", + "The instance is not available, for example due to problems with billing.", + "The instance is being deleted.", + "The instance is being created.", + "The instance is down for maintenance.", + "The creation of the instance failed or a fatal error occurred during maintenance.", + "Deprecated", + "(Applicable to read pool nodes only.) The read pool node needs to be repaired. The database might be unavailable." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "PscAutoConnectionConfig": { "description": "Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.", "id": "PscAutoConnectionConfig", @@ -6181,6 +6741,10 @@ "description": "The name of server Instance collation.", "type": "string" }, + "connectionPoolConfig": { + "$ref": "ConnectionPoolConfig", + "description": "Optional. The managed connection pooling configuration for the instance." + }, "connectorEnforcement": { "description": "Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors). Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance.", "enum": [ @@ -6204,6 +6768,16 @@ "$ref": "DataCacheConfig", "description": "Configuration for data cache." }, + "dataDiskProvisionedIops": { + "description": "Optional. Provisioned number of I/O operations per second for the data disk. This field is only used for hyperdisk-balanced disk types.", + "format": "int64", + "type": "string" + }, + "dataDiskProvisionedThroughput": { + "description": "Optional. Provisioned throughput measured in MiB per second for the data disk. This field is only used for hyperdisk-balanced disk types.", + "format": "int64", + "type": "string" + }, "dataDiskSizeGb": { "description": "The size of data disk, in GB. The data disk size minimum is 10GB.", "format": "int64", diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go index 64a9b8b436..31df2223fd 100644 --- a/sqladmin/v1/sqladmin-gen.go +++ b/sqladmin/v1/sqladmin-gen.go @@ -474,6 +474,84 @@ type Backup struct { // BackupRun: Output only. The mapping to backup run resource used for IAM // validations. BackupRun string `json:"backupRun,omitempty"` + // DatabaseVersion: Output only. The database version of the instance of when + // this backup was made. + // + // Possible values: + // "SQL_DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "MYSQL_5_1" - The database version is MySQL 5.1. + // "MYSQL_5_5" - The database version is MySQL 5.5. + // "MYSQL_5_6" - The database version is MySQL 5.6. + // "MYSQL_5_7" - The database version is MySQL 5.7. + // "MYSQL_8_0" - The database version is MySQL 8. + // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the minor + // version is 18. + // "MYSQL_8_0_26" - The database major version is MySQL 8.0 and the minor + // version is 26. + // "MYSQL_8_0_27" - The database major version is MySQL 8.0 and the minor + // version is 27. + // "MYSQL_8_0_28" - The database major version is MySQL 8.0 and the minor + // version is 28. + // "MYSQL_8_0_29" - The database major version is MySQL 8.0 and the minor + // version is 29. + // "MYSQL_8_0_30" - The database major version is MySQL 8.0 and the minor + // version is 30. + // "MYSQL_8_0_31" - The database major version is MySQL 8.0 and the minor + // version is 31. + // "MYSQL_8_0_32" - The database major version is MySQL 8.0 and the minor + // version is 32. + // "MYSQL_8_0_33" - The database major version is MySQL 8.0 and the minor + // version is 33. + // "MYSQL_8_0_34" - The database major version is MySQL 8.0 and the minor + // version is 34. + // "MYSQL_8_0_35" - The database major version is MySQL 8.0 and the minor + // version is 35. + // "MYSQL_8_0_36" - The database major version is MySQL 8.0 and the minor + // version is 36. + // "MYSQL_8_0_37" - The database major version is MySQL 8.0 and the minor + // version is 37. + // "MYSQL_8_0_38" - The database major version is MySQL 8.0 and the minor + // version is 38. + // "MYSQL_8_0_39" - The database major version is MySQL 8.0 and the minor + // version is 39. + // "MYSQL_8_0_40" - The database major version is MySQL 8.0 and the minor + // version is 40. + // "MYSQL_8_0_41" - The database major version is MySQL 8.0 and the minor + // version is 41. + // "MYSQL_8_0_42" - The database major version is MySQL 8.0 and the minor + // version is 42. + // "MYSQL_8_4" - The database version is MySQL 8.4. + // "SQLSERVER_2017_STANDARD" - The database version is SQL Server 2017 + // Standard. + // "SQLSERVER_2017_ENTERPRISE" - The database version is SQL Server 2017 + // Enterprise. + // "SQLSERVER_2017_EXPRESS" - The database version is SQL Server 2017 + // Express. + // "SQLSERVER_2017_WEB" - The database version is SQL Server 2017 Web. + // "POSTGRES_9_6" - The database version is PostgreSQL 9.6. + // "POSTGRES_10" - The database version is PostgreSQL 10. + // "POSTGRES_11" - The database version is PostgreSQL 11. + // "POSTGRES_12" - The database version is PostgreSQL 12. + // "POSTGRES_13" - The database version is PostgreSQL 13. + // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. + // "POSTGRES_16" - The database version is PostgreSQL 16. + // "POSTGRES_17" - The database version is PostgreSQL 17. + // "SQLSERVER_2019_STANDARD" - The database version is SQL Server 2019 + // Standard. + // "SQLSERVER_2019_ENTERPRISE" - The database version is SQL Server 2019 + // Enterprise. + // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 + // Express. + // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server 2022 + // Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. + DatabaseVersion string `json:"databaseVersion,omitempty"` // Description: The description of this backup. Description string `json:"description,omitempty"` // Error: Output only. Information about why the backup operation fails (for @@ -722,6 +800,84 @@ type BackupRun struct { // "SNAPSHOT" - Snapshot-based backups. // "PHYSICAL" - Physical backups. BackupKind string `json:"backupKind,omitempty"` + // DatabaseVersion: Output only. The instance database version when this backup + // was made. + // + // Possible values: + // "SQL_DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "MYSQL_5_1" - The database version is MySQL 5.1. + // "MYSQL_5_5" - The database version is MySQL 5.5. + // "MYSQL_5_6" - The database version is MySQL 5.6. + // "MYSQL_5_7" - The database version is MySQL 5.7. + // "MYSQL_8_0" - The database version is MySQL 8. + // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the minor + // version is 18. + // "MYSQL_8_0_26" - The database major version is MySQL 8.0 and the minor + // version is 26. + // "MYSQL_8_0_27" - The database major version is MySQL 8.0 and the minor + // version is 27. + // "MYSQL_8_0_28" - The database major version is MySQL 8.0 and the minor + // version is 28. + // "MYSQL_8_0_29" - The database major version is MySQL 8.0 and the minor + // version is 29. + // "MYSQL_8_0_30" - The database major version is MySQL 8.0 and the minor + // version is 30. + // "MYSQL_8_0_31" - The database major version is MySQL 8.0 and the minor + // version is 31. + // "MYSQL_8_0_32" - The database major version is MySQL 8.0 and the minor + // version is 32. + // "MYSQL_8_0_33" - The database major version is MySQL 8.0 and the minor + // version is 33. + // "MYSQL_8_0_34" - The database major version is MySQL 8.0 and the minor + // version is 34. + // "MYSQL_8_0_35" - The database major version is MySQL 8.0 and the minor + // version is 35. + // "MYSQL_8_0_36" - The database major version is MySQL 8.0 and the minor + // version is 36. + // "MYSQL_8_0_37" - The database major version is MySQL 8.0 and the minor + // version is 37. + // "MYSQL_8_0_38" - The database major version is MySQL 8.0 and the minor + // version is 38. + // "MYSQL_8_0_39" - The database major version is MySQL 8.0 and the minor + // version is 39. + // "MYSQL_8_0_40" - The database major version is MySQL 8.0 and the minor + // version is 40. + // "MYSQL_8_0_41" - The database major version is MySQL 8.0 and the minor + // version is 41. + // "MYSQL_8_0_42" - The database major version is MySQL 8.0 and the minor + // version is 42. + // "MYSQL_8_4" - The database version is MySQL 8.4. + // "SQLSERVER_2017_STANDARD" - The database version is SQL Server 2017 + // Standard. + // "SQLSERVER_2017_ENTERPRISE" - The database version is SQL Server 2017 + // Enterprise. + // "SQLSERVER_2017_EXPRESS" - The database version is SQL Server 2017 + // Express. + // "SQLSERVER_2017_WEB" - The database version is SQL Server 2017 Web. + // "POSTGRES_9_6" - The database version is PostgreSQL 9.6. + // "POSTGRES_10" - The database version is PostgreSQL 10. + // "POSTGRES_11" - The database version is PostgreSQL 11. + // "POSTGRES_12" - The database version is PostgreSQL 12. + // "POSTGRES_13" - The database version is PostgreSQL 13. + // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. + // "POSTGRES_16" - The database version is PostgreSQL 16. + // "POSTGRES_17" - The database version is PostgreSQL 17. + // "SQLSERVER_2019_STANDARD" - The database version is SQL Server 2019 + // Standard. + // "SQLSERVER_2019_ENTERPRISE" - The database version is SQL Server 2019 + // Enterprise. + // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 + // Express. + // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server 2022 + // Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. + DatabaseVersion string `json:"databaseVersion,omitempty"` // Description: The description of this run, only applicable to on-demand // backups. Description string `json:"description,omitempty"` @@ -923,6 +1079,35 @@ func (s CloneContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConnectPoolNodeConfig: Details of a single node of a read pool. +type ConnectPoolNodeConfig struct { + // DnsName: Output only. The DNS name of the node. + DnsName string `json:"dnsName,omitempty"` + // DnsNames: Output only. The list of DNS names used by this node. + DnsNames []*DnsNameMapping `json:"dnsNames,omitempty"` + // IpAddresses: Output only. Mappings containing IP addresses that can be used + // to connect to the node. + IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` + // Name: Output only. The name of the node. Doesn't include the project ID. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "DnsName") 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. "DnsName") 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 ConnectPoolNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConnectPoolNodeConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConnectSettings: Connect settings retrieval response. type ConnectSettings struct { // BackendType: `SECOND_GEN`: Cloud SQL database instance. `EXTERNAL`: A @@ -1033,6 +1218,11 @@ type ConnectSettings struct { IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` // Kind: This is always `sql#connectSettings`. Kind string `json:"kind,omitempty"` + // NodeCount: The number of nodes in a read pool. + NodeCount int64 `json:"nodeCount,omitempty"` + // Nodes: Output only. Entries containing information about each node of the + // read pool. + Nodes []*ConnectPoolNodeConfig `json:"nodes,omitempty"` // PscEnabled: Whether PSC connectivity is enabled for this instance. PscEnabled bool `json:"pscEnabled,omitempty"` // Region: The cloud region for the instance. For example, `us-central1`, @@ -1071,6 +1261,76 @@ func (s ConnectSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConnectionPoolConfig: The managed connection pooling configuration. +type ConnectionPoolConfig struct { + // ClientConnectionIdleTimeout: Client idle timeout. + ClientConnectionIdleTimeout string `json:"clientConnectionIdleTimeout,omitempty"` + // ConnPoolSize: Managed connection pool size. + ConnPoolSize int64 `json:"connPoolSize,omitempty"` + // ConnectionPoolingEnabled: Whether managed connection pooling is enabled. + ConnectionPoolingEnabled bool `json:"connectionPoolingEnabled,omitempty"` + // Flags: Optional. List of connection pool configuration flags + Flags []*ConnectionPoolFlags `json:"flags,omitempty"` + // MaxClientConnections: Maximum number of client connections in connection + // pool. + MaxClientConnections int64 `json:"maxClientConnections,omitempty"` + // PoolMode: The managed connection pool mode for the instance. + // + // Possible values: + // "POOL_MODE_UNSPECIFIED" - The pool mode is unknown. + // "SESSION" - The session mode for managed connection pooling. + // "TRANSACTION" - The transaction(default) mode for managed connection + // pooling. + PoolMode string `json:"poolMode,omitempty"` + // QueryWaitTimeout: Query wait timeout. + QueryWaitTimeout string `json:"queryWaitTimeout,omitempty"` + // ServerConnectionIdleTimeout: Server idle timeout. + ServerConnectionIdleTimeout string `json:"serverConnectionIdleTimeout,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "ClientConnectionIdleTimeout") 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. "ClientConnectionIdleTimeout") 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 ConnectionPoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConnectionPoolConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ConnectionPoolFlags: Connection pool flags for Cloud SQL instances managed +// connection pool configuration. +type ConnectionPoolFlags struct { + // Name: Required. The name of the flag. + Name string `json:"name,omitempty"` + // Value: Required. The value of the flag. Boolean flags are set to `on` for + // true and `off` for false. This field must be omitted if the flag doesn't + // take a value. + Value string `json:"value,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 ConnectionPoolFlags) MarshalJSON() ([]byte, error) { + type NoMethod ConnectionPoolFlags + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataCacheConfig: Data cache configurations. type DataCacheConfig struct { // DataCacheEnabled: Whether data cache is enabled for the instance. @@ -1314,6 +1574,7 @@ type DatabaseInstance struct { // "ON_PREMISES_INSTANCE" - An instance running on the customer's premises // that is not managed by Cloud SQL. // "READ_REPLICA_INSTANCE" - A Cloud SQL instance acting as a read-replica. + // "READ_POOL_INSTANCE" - CloudSQL read pool. InstanceType string `json:"instanceType,omitempty"` // IpAddresses: The assigned IP addresses for the instance. IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` @@ -1331,6 +1592,11 @@ type DatabaseInstance struct { MaxDiskSize int64 `json:"maxDiskSize,omitempty,string"` // Name: Name of the Cloud SQL instance. This does not include the project ID. Name string `json:"name,omitempty"` + // NodeCount: The number of nodes in a read pool. + NodeCount int64 `json:"nodeCount,omitempty"` + // Nodes: Output only. Entries containing information about each node of the + // read pool. + Nodes []*PoolNodeConfig `json:"nodes,omitempty"` // OnPremisesConfiguration: Configuration specific to on-premises instances. OnPremisesConfiguration *OnPremisesConfiguration `json:"onPremisesConfiguration,omitempty"` // OutOfDiskReport: This field represents the report generated by the proactive @@ -1407,6 +1673,8 @@ type DatabaseInstance struct { // "FAILED" - The creation of the instance failed or a fatal error occurred // during maintenance. // "ONLINE_MAINTENANCE" - Deprecated + // "REPAIRING" - (Applicable to read pool nodes only.) The read pool node + // needs to be repaired. The database might be unavailable. State string `json:"state,omitempty"` // SuspensionReason: If the instance state is SUSPENDED, the reason for the // suspension. @@ -2187,6 +2455,13 @@ type Flag struct { // Express. // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. AppliesTo []string `json:"appliesTo,omitempty"` + // FlagScope: Scope of flag. + // + // Possible values: + // "SQL_FLAG_SCOPE_UNSPECIFIED" - Assume database flags if unspecified + // "SQL_FLAG_SCOPE_DATABASE" - database flags + // "SQL_FLAG_SCOPE_CONNECTION_POOL" - connection pool configuration flags + FlagScope string `json:"flagScope,omitempty"` // InBeta: Whether or not the flag is considered in beta. InBeta bool `json:"inBeta,omitempty"` // Kind: This is always `sql#flag`. @@ -2198,6 +2473,11 @@ type Flag struct { // Name: This is the name of the flag. Flag names always use underscores, not // hyphens, for example: `max_allowed_packet` Name string `json:"name,omitempty"` + // RecommendedIntValue: Recommended int value in integer format for UI display. + RecommendedIntValue int64 `json:"recommendedIntValue,omitempty,string"` + // RecommendedStringValue: Recommended string value in string format for UI + // display. + RecommendedStringValue string `json:"recommendedStringValue,omitempty"` // RequiresRestart: Indicates whether changing this flag will trigger a // database restart. Only applicable to Second Generation instances. RequiresRestart bool `json:"requiresRestart,omitempty"` @@ -3593,6 +3873,9 @@ type Operation struct { // "MANAGE_BACKUP" - Changes the BackupTier of a Cloud SQL instance. // "ENHANCED_BACKUP" - Creates a backup for an Enhanced BackupTier Cloud SQL // instance. + // "REPAIR_READ_POOL" - Repairs entire read pool or specified nodes in the + // read pool. + // "CREATE_READ_POOL" - Creates a Cloud SQL read pool instance. OperationType string `json:"operationType,omitempty"` // SelfLink: The URI of this resource. SelfLink string `json:"selfLink,omitempty"` @@ -3847,6 +4130,54 @@ func (s PerformDiskShrinkContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PoolNodeConfig: Details of a single node of a read pool. +type PoolNodeConfig struct { + // DnsName: Output only. The DNS name of the node. + DnsName string `json:"dnsName,omitempty"` + // DnsNames: Output only. The list of DNS names used by this node. + DnsNames []*DnsNameMapping `json:"dnsNames,omitempty"` + // GceZone: Output only. The serving zone of the node. + GceZone string `json:"gceZone,omitempty"` + // IpAddresses: Output only. Mappings containing IP addresses that can be used + // to connect to the node. + IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` + // Name: Output only. The name of the node, to be used for retrieving metrics + // and logs for the node. + Name string `json:"name,omitempty"` + // State: Output only. The current state of the node. + // + // Possible values: + // "SQL_INSTANCE_STATE_UNSPECIFIED" - The state of the instance is unknown. + // "RUNNABLE" - The instance is running, or has been stopped by owner. + // "SUSPENDED" - The instance is not available, for example due to problems + // with billing. + // "PENDING_DELETE" - The instance is being deleted. + // "PENDING_CREATE" - The instance is being created. + // "MAINTENANCE" - The instance is down for maintenance. + // "FAILED" - The creation of the instance failed or a fatal error occurred + // during maintenance. + // "ONLINE_MAINTENANCE" - Deprecated + // "REPAIRING" - (Applicable to read pool nodes only.) The read pool node + // needs to be repaired. The database might be unavailable. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "DnsName") 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. "DnsName") 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 PoolNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod PoolNodeConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // PscAutoConnectionConfig: Settings for an automatically-setup Private Service // Connect consumer endpoint that is used to connect to a Cloud SQL instance. type PscAutoConnectionConfig struct { @@ -4176,6 +4507,9 @@ type Settings struct { BackupConfiguration *BackupConfiguration `json:"backupConfiguration,omitempty"` // Collation: The name of server Instance collation. Collation string `json:"collation,omitempty"` + // ConnectionPoolConfig: Optional. The managed connection pooling configuration + // for the instance. + ConnectionPoolConfig *ConnectionPoolConfig `json:"connectionPoolConfig,omitempty"` // ConnectorEnforcement: Specifies if connections must use Cloud SQL // connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL // instances can be connected without Cloud SQL Connectors) and `REQUIRED` @@ -4199,6 +4533,14 @@ type Settings struct { CrashSafeReplicationEnabled bool `json:"crashSafeReplicationEnabled,omitempty"` // DataCacheConfig: Configuration for data cache. DataCacheConfig *DataCacheConfig `json:"dataCacheConfig,omitempty"` + // DataDiskProvisionedIops: Optional. Provisioned number of I/O operations per + // second for the data disk. This field is only used for hyperdisk-balanced + // disk types. + DataDiskProvisionedIops int64 `json:"dataDiskProvisionedIops,omitempty,string"` + // DataDiskProvisionedThroughput: Optional. Provisioned throughput measured in + // MiB per second for the data disk. This field is only used for + // hyperdisk-balanced disk types. + DataDiskProvisionedThroughput int64 `json:"dataDiskProvisionedThroughput,omitempty,string"` // DataDiskSizeGb: The size of data disk, in GB. The data disk size minimum is // 10GB. DataDiskSizeGb int64 `json:"dataDiskSizeGb,omitempty,string"` @@ -7388,6 +7730,20 @@ func (c *FlagsListCall) DatabaseVersion(databaseVersion string) *FlagsListCall { return c } +// FlagScope sets the optional parameter "flagScope": Specify the scope of +// flags to be returned by SqlFlagsListService. Return list of database flags +// if unspecified. +// +// Possible values: +// +// "SQL_FLAG_SCOPE_UNSPECIFIED" - Assume database flags if unspecified +// "SQL_FLAG_SCOPE_DATABASE" - database flags +// "SQL_FLAG_SCOPE_CONNECTION_POOL" - connection pool configuration flags +func (c *FlagsListCall) FlagScope(flagScope string) *FlagsListCall { + c.urlParams_.Set("flagScope", flagScope) + 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/sqladmin/v1beta4/sqladmin-api.json b/sqladmin/v1beta4/sqladmin-api.json index 3e4325c37f..5aa3b2c52b 100644 --- a/sqladmin/v1beta4/sqladmin-api.json +++ b/sqladmin/v1beta4/sqladmin-api.json @@ -755,6 +755,21 @@ "description": "Database type and version you want to retrieve flags for. By default, this method returns flags for all database types and versions.", "location": "query", "type": "string" + }, + "flagScope": { + "description": "Optional. Specify the scope of flags to be returned by SqlFlagsListService. Return list of database flags if unspecified.", + "enum": [ + "SQL_FLAG_SCOPE_UNSPECIFIED", + "SQL_FLAG_SCOPE_DATABASE", + "SQL_FLAG_SCOPE_CONNECTION_POOL" + ], + "enumDescriptions": [ + "Assume database flags if unspecified", + "database flags", + "connection pool configuration flags" + ], + "location": "query", + "type": "string" } }, "path": "sql/v1beta4/flags", @@ -2550,7 +2565,7 @@ } } }, - "revision": "20250226", + "revision": "20250310", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2694,6 +2709,155 @@ "readOnly": true, "type": "string" }, + "databaseVersion": { + "description": "Output only. The database version of the instance of when this backup was made.", + "enum": [ + "SQL_DATABASE_VERSION_UNSPECIFIED", + "MYSQL_5_1", + "MYSQL_5_5", + "MYSQL_5_6", + "MYSQL_5_7", + "MYSQL_8_0", + "MYSQL_8_0_18", + "MYSQL_8_0_26", + "MYSQL_8_0_27", + "MYSQL_8_0_28", + "MYSQL_8_0_29", + "MYSQL_8_0_30", + "MYSQL_8_0_31", + "MYSQL_8_0_32", + "MYSQL_8_0_33", + "MYSQL_8_0_34", + "MYSQL_8_0_35", + "MYSQL_8_0_36", + "MYSQL_8_0_37", + "MYSQL_8_0_38", + "MYSQL_8_0_39", + "MYSQL_8_0_40", + "MYSQL_8_0_41", + "MYSQL_8_0_42", + "MYSQL_8_4", + "SQLSERVER_2017_STANDARD", + "SQLSERVER_2017_ENTERPRISE", + "SQLSERVER_2017_EXPRESS", + "SQLSERVER_2017_WEB", + "POSTGRES_9_6", + "POSTGRES_10", + "POSTGRES_11", + "POSTGRES_12", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16", + "POSTGRES_17", + "SQLSERVER_2019_STANDARD", + "SQLSERVER_2019_ENTERPRISE", + "SQLSERVER_2019_EXPRESS", + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" + ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "The database version is MySQL 5.1.", + "The database version is MySQL 5.5.", + "The database version is MySQL 5.6.", + "The database version is MySQL 5.7.", + "The database version is MySQL 8.", + "The database major version is MySQL 8.0 and the minor version is 18.", + "The database major version is MySQL 8.0 and the minor version is 26.", + "The database major version is MySQL 8.0 and the minor version is 27.", + "The database major version is MySQL 8.0 and the minor version is 28.", + "The database major version is MySQL 8.0 and the minor version is 29.", + "The database major version is MySQL 8.0 and the minor version is 30.", + "The database major version is MySQL 8.0 and the minor version is 31.", + "The database major version is MySQL 8.0 and the minor version is 32.", + "The database major version is MySQL 8.0 and the minor version is 33.", + "The database major version is MySQL 8.0 and the minor version is 34.", + "The database major version is MySQL 8.0 and the minor version is 35.", + "The database major version is MySQL 8.0 and the minor version is 36.", + "The database major version is MySQL 8.0 and the minor version is 37.", + "The database major version is MySQL 8.0 and the minor version is 38.", + "The database major version is MySQL 8.0 and the minor version is 39.", + "The database major version is MySQL 8.0 and the minor version is 40.", + "The database major version is MySQL 8.0 and the minor version is 41.", + "The database major version is MySQL 8.0 and the minor version is 42.", + "The database version is MySQL 8.4.", + "The database version is SQL Server 2017 Standard.", + "The database version is SQL Server 2017 Enterprise.", + "The database version is SQL Server 2017 Express.", + "The database version is SQL Server 2017 Web.", + "The database version is PostgreSQL 9.6.", + "The database version is PostgreSQL 10.", + "The database version is PostgreSQL 11.", + "The database version is PostgreSQL 12.", + "The database version is PostgreSQL 13.", + "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", + "The database version is PostgreSQL 16.", + "The database version is PostgreSQL 17.", + "The database version is SQL Server 2019 Standard.", + "The database version is SQL Server 2019 Enterprise.", + "The database version is SQL Server 2019 Express.", + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." + ], + "readOnly": true, + "type": "string" + }, "description": { "description": "The description of this backup.", "type": "string" @@ -2972,6 +3136,155 @@ ], "type": "string" }, + "databaseVersion": { + "description": "Output only. The instance database version when this backup was made.", + "enum": [ + "SQL_DATABASE_VERSION_UNSPECIFIED", + "MYSQL_5_1", + "MYSQL_5_5", + "MYSQL_5_6", + "MYSQL_5_7", + "MYSQL_8_0", + "MYSQL_8_0_18", + "MYSQL_8_0_26", + "MYSQL_8_0_27", + "MYSQL_8_0_28", + "MYSQL_8_0_29", + "MYSQL_8_0_30", + "MYSQL_8_0_31", + "MYSQL_8_0_32", + "MYSQL_8_0_33", + "MYSQL_8_0_34", + "MYSQL_8_0_35", + "MYSQL_8_0_36", + "MYSQL_8_0_37", + "MYSQL_8_0_38", + "MYSQL_8_0_39", + "MYSQL_8_0_40", + "MYSQL_8_0_41", + "MYSQL_8_0_42", + "MYSQL_8_4", + "SQLSERVER_2017_STANDARD", + "SQLSERVER_2017_ENTERPRISE", + "SQLSERVER_2017_EXPRESS", + "SQLSERVER_2017_WEB", + "POSTGRES_9_6", + "POSTGRES_10", + "POSTGRES_11", + "POSTGRES_12", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16", + "POSTGRES_17", + "SQLSERVER_2019_STANDARD", + "SQLSERVER_2019_ENTERPRISE", + "SQLSERVER_2019_EXPRESS", + "SQLSERVER_2019_WEB", + "SQLSERVER_2022_STANDARD", + "SQLSERVER_2022_ENTERPRISE", + "SQLSERVER_2022_EXPRESS", + "SQLSERVER_2022_WEB" + ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "The database version is MySQL 5.1.", + "The database version is MySQL 5.5.", + "The database version is MySQL 5.6.", + "The database version is MySQL 5.7.", + "The database version is MySQL 8.", + "The database major version is MySQL 8.0 and the minor version is 18.", + "The database major version is MySQL 8.0 and the minor version is 26.", + "The database major version is MySQL 8.0 and the minor version is 27.", + "The database major version is MySQL 8.0 and the minor version is 28.", + "The database major version is MySQL 8.0 and the minor version is 29.", + "The database major version is MySQL 8.0 and the minor version is 30.", + "The database major version is MySQL 8.0 and the minor version is 31.", + "The database major version is MySQL 8.0 and the minor version is 32.", + "The database major version is MySQL 8.0 and the minor version is 33.", + "The database major version is MySQL 8.0 and the minor version is 34.", + "The database major version is MySQL 8.0 and the minor version is 35.", + "The database major version is MySQL 8.0 and the minor version is 36.", + "The database major version is MySQL 8.0 and the minor version is 37.", + "The database major version is MySQL 8.0 and the minor version is 38.", + "The database major version is MySQL 8.0 and the minor version is 39.", + "The database major version is MySQL 8.0 and the minor version is 40.", + "The database major version is MySQL 8.0 and the minor version is 41.", + "The database major version is MySQL 8.0 and the minor version is 42.", + "The database version is MySQL 8.4.", + "The database version is SQL Server 2017 Standard.", + "The database version is SQL Server 2017 Enterprise.", + "The database version is SQL Server 2017 Express.", + "The database version is SQL Server 2017 Web.", + "The database version is PostgreSQL 9.6.", + "The database version is PostgreSQL 10.", + "The database version is PostgreSQL 11.", + "The database version is PostgreSQL 12.", + "The database version is PostgreSQL 13.", + "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", + "The database version is PostgreSQL 16.", + "The database version is PostgreSQL 17.", + "The database version is SQL Server 2019 Standard.", + "The database version is SQL Server 2019 Enterprise.", + "The database version is SQL Server 2019 Express.", + "The database version is SQL Server 2019 Web.", + "The database version is SQL Server 2022 Standard.", + "The database version is SQL Server 2022 Enterprise.", + "The database version is SQL Server 2022 Express.", + "The database version is SQL Server 2022 Web." + ], + "readOnly": true, + "type": "string" + }, "description": { "description": "The description of this run, only applicable to on-demand backups.", "type": "string" @@ -3174,6 +3487,39 @@ }, "type": "object" }, + "ConnectPoolNodeConfig": { + "description": "Details of a single node of a read pool.", + "id": "ConnectPoolNodeConfig", + "properties": { + "dnsName": { + "description": "Output only. The DNS name of the node.", + "readOnly": true, + "type": "string" + }, + "dnsNames": { + "description": "Output only. The list of DNS names used by this instance.", + "items": { + "$ref": "DnsNameMapping" + }, + "readOnly": true, + "type": "array" + }, + "ipAddresses": { + "description": "Output only. Mappings containing IP addresses that can be used to connect to the node.", + "items": { + "$ref": "IpMapping" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The name of the node. Doesn't include the project ID.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ConnectSettings": { "description": "Connect settings retrieval response.", "id": "ConnectSettings", @@ -3378,6 +3724,19 @@ "description": "This is always `sql#connectSettings`.", "type": "string" }, + "nodeCount": { + "description": "The number of nodes in a read pool.", + "format": "int32", + "type": "integer" + }, + "nodes": { + "description": "Output only. Entries containing information about each node of the read pool.", + "items": { + "$ref": "ConnectPoolNodeConfig" + }, + "readOnly": true, + "type": "array" + }, "pscEnabled": { "description": "Whether PSC connectivity is enabled for this instance.", "type": "boolean" @@ -3409,6 +3768,84 @@ }, "type": "object" }, + "ConnectionPoolConfig": { + "description": "The managed connection pooling configuration.", + "id": "ConnectionPoolConfig", + "properties": { + "clientConnectionIdleTimeout": { + "deprecated": true, + "description": "Client idle timeout.", + "format": "google-duration", + "type": "string" + }, + "connPoolSize": { + "deprecated": true, + "description": "Managed connection pool size.", + "format": "int32", + "type": "integer" + }, + "connectionPoolingEnabled": { + "description": "Whether managed connection pooling is enabled.", + "type": "boolean" + }, + "flags": { + "description": "Optional. List of connection pool configuration flags", + "items": { + "$ref": "ConnectionPoolFlags" + }, + "type": "array" + }, + "maxClientConnections": { + "deprecated": true, + "description": "Maximum number of client connections in connection pool.", + "format": "int32", + "type": "integer" + }, + "poolMode": { + "deprecated": true, + "description": "The managed connection pool mode for the instance.", + "enum": [ + "POOL_MODE_UNSPECIFIED", + "SESSION", + "TRANSACTION" + ], + "enumDescriptions": [ + "The pool mode is unknown.", + "The session mode for managed connection pooling.", + "The transaction(default) mode for managed connection pooling." + ], + "type": "string" + }, + "queryWaitTimeout": { + "deprecated": true, + "description": "Query wait timeout.", + "format": "google-duration", + "type": "string" + }, + "serverConnectionIdleTimeout": { + "deprecated": true, + "description": "Server idle timeout.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, + "ConnectionPoolFlags": { + "description": "Connection pool flags for Cloud SQL instances managed connection pool configuration.", + "id": "ConnectionPoolFlags", + "properties": { + "name": { + "description": "Required. The name of the flag.", + "type": "string" + }, + "value": { + "description": "Required. The value of the flag. Boolean flags are set to `on` for true and `off` for false. This field must be omitted if the flag doesn't take a value.", + "type": "string" + } + }, + "type": "object" + }, "DataCacheConfig": { "description": "Data cache configurations.", "id": "DataCacheConfig", @@ -3737,13 +4174,15 @@ "SQL_INSTANCE_TYPE_UNSPECIFIED", "CLOUD_SQL_INSTANCE", "ON_PREMISES_INSTANCE", - "READ_REPLICA_INSTANCE" + "READ_REPLICA_INSTANCE", + "READ_POOL_INSTANCE" ], "enumDescriptions": [ "This is an unknown Cloud SQL instance type.", "A regular Cloud SQL instance that is not replicating from a primary instance.", "An instance running on the customer's premises that is not managed by Cloud SQL.", - "A Cloud SQL instance acting as a read-replica." + "A Cloud SQL instance acting as a read-replica.", + "CloudSQL read pool." ], "type": "string" }, @@ -3781,6 +4220,19 @@ "description": "Name of the Cloud SQL instance. This does not include the project ID.", "type": "string" }, + "nodeCount": { + "description": "The number of nodes in a read pool.", + "format": "int32", + "type": "integer" + }, + "nodes": { + "description": "Output only. Entries containing information about each node of the read pool.", + "items": { + "$ref": "PoolNodeConfig" + }, + "readOnly": true, + "type": "array" + }, "onPremisesConfiguration": { "$ref": "OnPremisesConfiguration", "description": "Configuration specific to on-premises instances." @@ -3884,7 +4336,8 @@ "PENDING_CREATE", "MAINTENANCE", "FAILED", - "ONLINE_MAINTENANCE" + "ONLINE_MAINTENANCE", + "REPAIRING" ], "enumDeprecated": [ false, @@ -3894,7 +4347,8 @@ false, false, false, - true + true, + false ], "enumDescriptions": [ "The state of the instance is unknown.", @@ -3904,7 +4358,8 @@ "The instance is being created.", "The instance is down for maintenance.", "The creation of the instance failed or a fatal error occurred during maintenance.", - "Deprecated" + "Deprecated", + "(Applicable to read pool nodes only.) The read pool node needs to be repaired. The database might be unavailable." ], "type": "string" }, @@ -4548,6 +5003,20 @@ }, "type": "array" }, + "flagScope": { + "description": "Scope of flag.", + "enum": [ + "SQL_FLAG_SCOPE_UNSPECIFIED", + "SQL_FLAG_SCOPE_DATABASE", + "SQL_FLAG_SCOPE_CONNECTION_POOL" + ], + "enumDescriptions": [ + "Assume database flags if unspecified", + "database flags", + "connection pool configuration flags" + ], + "type": "string" + }, "inBeta": { "description": "Whether or not the flag is considered in beta.", "type": "boolean" @@ -4570,6 +5039,15 @@ "description": "This is the name of the flag. Flag names always use underscores, not hyphens, for example: `max_allowed_packet`", "type": "string" }, + "recommendedIntValue": { + "description": "Recommended flag value in integer format for UI display.", + "format": "int64", + "type": "string" + }, + "recommendedStringValue": { + "description": "Recommended flag value in string format for UI display.", + "type": "string" + }, "requiresRestart": { "description": "Indicates whether changing this flag will trigger a database restart. Only applicable to Second Generation instances.", "type": "boolean" @@ -5597,7 +6075,9 @@ "MAJOR_VERSION_UPGRADE", "ADVANCED_BACKUP", "MANAGE_BACKUP", - "ENHANCED_BACKUP" + "ENHANCED_BACKUP", + "REPAIR_READ_POOL", + "CREATE_READ_POOL" ], "enumDeprecated": [ false, @@ -5649,6 +6129,8 @@ false, true, false, + false, + false, false ], "enumDescriptions": [ @@ -5701,7 +6183,9 @@ "Updates the major version of a Cloud SQL instance.", "Deprecated: ADVANCED_BACKUP is deprecated. Use ENHANCED_BACKUP instead.", "Changes the BackupTier of a Cloud SQL instance.", - "Creates a backup for an Enhanced BackupTier Cloud SQL instance." + "Creates a backup for an Enhanced BackupTier Cloud SQL instance.", + "Repairs entire read pool or specified nodes in the read pool.", + "Creates a Cloud SQL read pool instance." ], "type": "string" }, @@ -5930,6 +6414,82 @@ }, "type": "object" }, + "PoolNodeConfig": { + "description": "Details of a single node of a read pool.", + "id": "PoolNodeConfig", + "properties": { + "dnsName": { + "description": "Output only. The DNS name of the node.", + "readOnly": true, + "type": "string" + }, + "dnsNames": { + "description": "Output only. The list of DNS names used by this node.", + "items": { + "$ref": "DnsNameMapping" + }, + "readOnly": true, + "type": "array" + }, + "gceZone": { + "description": "Output only. The serving zone of the node.", + "readOnly": true, + "type": "string" + }, + "ipAddresses": { + "description": "Output only. Mappings containing IP addresses that can be used to connect to the node.", + "items": { + "$ref": "IpMapping" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Output only. The name of the node, to be used for retrieving metrics and logs for the node.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of the node.", + "enum": [ + "SQL_INSTANCE_STATE_UNSPECIFIED", + "RUNNABLE", + "SUSPENDED", + "PENDING_DELETE", + "PENDING_CREATE", + "MAINTENANCE", + "FAILED", + "ONLINE_MAINTENANCE", + "REPAIRING" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true, + false + ], + "enumDescriptions": [ + "The state of the instance is unknown.", + "The instance is running, or has been stopped by owner.", + "The instance is not available, for example due to problems with billing.", + "The instance is being deleted.", + "The instance is being created.", + "The instance is down for maintenance.", + "The creation of the instance failed or a fatal error occurred during maintenance.", + "Deprecated", + "(Applicable to read pool nodes only.) The read pool node needs to be repaired. The database might be unavailable." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "PscAutoConnectionConfig": { "description": "Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.", "id": "PscAutoConnectionConfig", @@ -6182,6 +6742,10 @@ "description": "The name of server Instance collation.", "type": "string" }, + "connectionPoolConfig": { + "$ref": "ConnectionPoolConfig", + "description": "Optional. The managed connection pooling configuration for the instance." + }, "connectorEnforcement": { "description": "Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance.", "enum": [ @@ -6205,6 +6769,16 @@ "$ref": "DataCacheConfig", "description": "Configuration for data cache." }, + "dataDiskProvisionedIops": { + "description": "Optional. Provisioned number of I/O operations per second for the data disk. This field is only used for hyperdisk-balanced disk types.", + "format": "int64", + "type": "string" + }, + "dataDiskProvisionedThroughput": { + "description": "Optional. Provisioned throughput measured in MiB per second for the data disk. This field is only used for hyperdisk-balanced disk types.", + "format": "int64", + "type": "string" + }, "dataDiskSizeGb": { "description": "The size of data disk, in GB. The data disk size minimum is 10GB.", "format": "int64", diff --git a/sqladmin/v1beta4/sqladmin-gen.go b/sqladmin/v1beta4/sqladmin-gen.go index 823211de8a..7d30147324 100644 --- a/sqladmin/v1beta4/sqladmin-gen.go +++ b/sqladmin/v1beta4/sqladmin-gen.go @@ -474,6 +474,84 @@ type Backup struct { // BackupRun: Output only. The mapping to backup run resource used for IAM // validations. BackupRun string `json:"backupRun,omitempty"` + // DatabaseVersion: Output only. The database version of the instance of when + // this backup was made. + // + // Possible values: + // "SQL_DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "MYSQL_5_1" - The database version is MySQL 5.1. + // "MYSQL_5_5" - The database version is MySQL 5.5. + // "MYSQL_5_6" - The database version is MySQL 5.6. + // "MYSQL_5_7" - The database version is MySQL 5.7. + // "MYSQL_8_0" - The database version is MySQL 8. + // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the minor + // version is 18. + // "MYSQL_8_0_26" - The database major version is MySQL 8.0 and the minor + // version is 26. + // "MYSQL_8_0_27" - The database major version is MySQL 8.0 and the minor + // version is 27. + // "MYSQL_8_0_28" - The database major version is MySQL 8.0 and the minor + // version is 28. + // "MYSQL_8_0_29" - The database major version is MySQL 8.0 and the minor + // version is 29. + // "MYSQL_8_0_30" - The database major version is MySQL 8.0 and the minor + // version is 30. + // "MYSQL_8_0_31" - The database major version is MySQL 8.0 and the minor + // version is 31. + // "MYSQL_8_0_32" - The database major version is MySQL 8.0 and the minor + // version is 32. + // "MYSQL_8_0_33" - The database major version is MySQL 8.0 and the minor + // version is 33. + // "MYSQL_8_0_34" - The database major version is MySQL 8.0 and the minor + // version is 34. + // "MYSQL_8_0_35" - The database major version is MySQL 8.0 and the minor + // version is 35. + // "MYSQL_8_0_36" - The database major version is MySQL 8.0 and the minor + // version is 36. + // "MYSQL_8_0_37" - The database major version is MySQL 8.0 and the minor + // version is 37. + // "MYSQL_8_0_38" - The database major version is MySQL 8.0 and the minor + // version is 38. + // "MYSQL_8_0_39" - The database major version is MySQL 8.0 and the minor + // version is 39. + // "MYSQL_8_0_40" - The database major version is MySQL 8.0 and the minor + // version is 40. + // "MYSQL_8_0_41" - The database major version is MySQL 8.0 and the minor + // version is 41. + // "MYSQL_8_0_42" - The database major version is MySQL 8.0 and the minor + // version is 42. + // "MYSQL_8_4" - The database version is MySQL 8.4. + // "SQLSERVER_2017_STANDARD" - The database version is SQL Server 2017 + // Standard. + // "SQLSERVER_2017_ENTERPRISE" - The database version is SQL Server 2017 + // Enterprise. + // "SQLSERVER_2017_EXPRESS" - The database version is SQL Server 2017 + // Express. + // "SQLSERVER_2017_WEB" - The database version is SQL Server 2017 Web. + // "POSTGRES_9_6" - The database version is PostgreSQL 9.6. + // "POSTGRES_10" - The database version is PostgreSQL 10. + // "POSTGRES_11" - The database version is PostgreSQL 11. + // "POSTGRES_12" - The database version is PostgreSQL 12. + // "POSTGRES_13" - The database version is PostgreSQL 13. + // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. + // "POSTGRES_16" - The database version is PostgreSQL 16. + // "POSTGRES_17" - The database version is PostgreSQL 17. + // "SQLSERVER_2019_STANDARD" - The database version is SQL Server 2019 + // Standard. + // "SQLSERVER_2019_ENTERPRISE" - The database version is SQL Server 2019 + // Enterprise. + // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 + // Express. + // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server 2022 + // Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. + DatabaseVersion string `json:"databaseVersion,omitempty"` // Description: The description of this backup. Description string `json:"description,omitempty"` // Error: Output only. Information about why the backup operation fails (for @@ -721,6 +799,84 @@ type BackupRun struct { // "SNAPSHOT" - Snapshot-based backups. // "PHYSICAL" - Physical backups. BackupKind string `json:"backupKind,omitempty"` + // DatabaseVersion: Output only. The instance database version when this backup + // was made. + // + // Possible values: + // "SQL_DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "MYSQL_5_1" - The database version is MySQL 5.1. + // "MYSQL_5_5" - The database version is MySQL 5.5. + // "MYSQL_5_6" - The database version is MySQL 5.6. + // "MYSQL_5_7" - The database version is MySQL 5.7. + // "MYSQL_8_0" - The database version is MySQL 8. + // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the minor + // version is 18. + // "MYSQL_8_0_26" - The database major version is MySQL 8.0 and the minor + // version is 26. + // "MYSQL_8_0_27" - The database major version is MySQL 8.0 and the minor + // version is 27. + // "MYSQL_8_0_28" - The database major version is MySQL 8.0 and the minor + // version is 28. + // "MYSQL_8_0_29" - The database major version is MySQL 8.0 and the minor + // version is 29. + // "MYSQL_8_0_30" - The database major version is MySQL 8.0 and the minor + // version is 30. + // "MYSQL_8_0_31" - The database major version is MySQL 8.0 and the minor + // version is 31. + // "MYSQL_8_0_32" - The database major version is MySQL 8.0 and the minor + // version is 32. + // "MYSQL_8_0_33" - The database major version is MySQL 8.0 and the minor + // version is 33. + // "MYSQL_8_0_34" - The database major version is MySQL 8.0 and the minor + // version is 34. + // "MYSQL_8_0_35" - The database major version is MySQL 8.0 and the minor + // version is 35. + // "MYSQL_8_0_36" - The database major version is MySQL 8.0 and the minor + // version is 36. + // "MYSQL_8_0_37" - The database major version is MySQL 8.0 and the minor + // version is 37. + // "MYSQL_8_0_38" - The database major version is MySQL 8.0 and the minor + // version is 38. + // "MYSQL_8_0_39" - The database major version is MySQL 8.0 and the minor + // version is 39. + // "MYSQL_8_0_40" - The database major version is MySQL 8.0 and the minor + // version is 40. + // "MYSQL_8_0_41" - The database major version is MySQL 8.0 and the minor + // version is 41. + // "MYSQL_8_0_42" - The database major version is MySQL 8.0 and the minor + // version is 42. + // "MYSQL_8_4" - The database version is MySQL 8.4. + // "SQLSERVER_2017_STANDARD" - The database version is SQL Server 2017 + // Standard. + // "SQLSERVER_2017_ENTERPRISE" - The database version is SQL Server 2017 + // Enterprise. + // "SQLSERVER_2017_EXPRESS" - The database version is SQL Server 2017 + // Express. + // "SQLSERVER_2017_WEB" - The database version is SQL Server 2017 Web. + // "POSTGRES_9_6" - The database version is PostgreSQL 9.6. + // "POSTGRES_10" - The database version is PostgreSQL 10. + // "POSTGRES_11" - The database version is PostgreSQL 11. + // "POSTGRES_12" - The database version is PostgreSQL 12. + // "POSTGRES_13" - The database version is PostgreSQL 13. + // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. + // "POSTGRES_16" - The database version is PostgreSQL 16. + // "POSTGRES_17" - The database version is PostgreSQL 17. + // "SQLSERVER_2019_STANDARD" - The database version is SQL Server 2019 + // Standard. + // "SQLSERVER_2019_ENTERPRISE" - The database version is SQL Server 2019 + // Enterprise. + // "SQLSERVER_2019_EXPRESS" - The database version is SQL Server 2019 + // Express. + // "SQLSERVER_2019_WEB" - The database version is SQL Server 2019 Web. + // "SQLSERVER_2022_STANDARD" - The database version is SQL Server 2022 + // Standard. + // "SQLSERVER_2022_ENTERPRISE" - The database version is SQL Server 2022 + // Enterprise. + // "SQLSERVER_2022_EXPRESS" - The database version is SQL Server 2022 + // Express. + // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. + DatabaseVersion string `json:"databaseVersion,omitempty"` // Description: The description of this run, only applicable to on-demand // backups. Description string `json:"description,omitempty"` @@ -922,6 +1078,35 @@ func (s CloneContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConnectPoolNodeConfig: Details of a single node of a read pool. +type ConnectPoolNodeConfig struct { + // DnsName: Output only. The DNS name of the node. + DnsName string `json:"dnsName,omitempty"` + // DnsNames: Output only. The list of DNS names used by this instance. + DnsNames []*DnsNameMapping `json:"dnsNames,omitempty"` + // IpAddresses: Output only. Mappings containing IP addresses that can be used + // to connect to the node. + IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` + // Name: Output only. The name of the node. Doesn't include the project ID. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "DnsName") 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. "DnsName") 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 ConnectPoolNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConnectPoolNodeConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConnectSettings: Connect settings retrieval response. type ConnectSettings struct { // BackendType: `SECOND_GEN`: Cloud SQL database instance. `EXTERNAL`: A @@ -1032,6 +1217,11 @@ type ConnectSettings struct { IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` // Kind: This is always `sql#connectSettings`. Kind string `json:"kind,omitempty"` + // NodeCount: The number of nodes in a read pool. + NodeCount int64 `json:"nodeCount,omitempty"` + // Nodes: Output only. Entries containing information about each node of the + // read pool. + Nodes []*ConnectPoolNodeConfig `json:"nodes,omitempty"` // PscEnabled: Whether PSC connectivity is enabled for this instance. PscEnabled bool `json:"pscEnabled,omitempty"` // Region: The cloud region for the instance. e.g. `us-central1`, @@ -1071,6 +1261,76 @@ func (s ConnectSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConnectionPoolConfig: The managed connection pooling configuration. +type ConnectionPoolConfig struct { + // ClientConnectionIdleTimeout: Client idle timeout. + ClientConnectionIdleTimeout string `json:"clientConnectionIdleTimeout,omitempty"` + // ConnPoolSize: Managed connection pool size. + ConnPoolSize int64 `json:"connPoolSize,omitempty"` + // ConnectionPoolingEnabled: Whether managed connection pooling is enabled. + ConnectionPoolingEnabled bool `json:"connectionPoolingEnabled,omitempty"` + // Flags: Optional. List of connection pool configuration flags + Flags []*ConnectionPoolFlags `json:"flags,omitempty"` + // MaxClientConnections: Maximum number of client connections in connection + // pool. + MaxClientConnections int64 `json:"maxClientConnections,omitempty"` + // PoolMode: The managed connection pool mode for the instance. + // + // Possible values: + // "POOL_MODE_UNSPECIFIED" - The pool mode is unknown. + // "SESSION" - The session mode for managed connection pooling. + // "TRANSACTION" - The transaction(default) mode for managed connection + // pooling. + PoolMode string `json:"poolMode,omitempty"` + // QueryWaitTimeout: Query wait timeout. + QueryWaitTimeout string `json:"queryWaitTimeout,omitempty"` + // ServerConnectionIdleTimeout: Server idle timeout. + ServerConnectionIdleTimeout string `json:"serverConnectionIdleTimeout,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "ClientConnectionIdleTimeout") 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. "ClientConnectionIdleTimeout") 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 ConnectionPoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConnectionPoolConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ConnectionPoolFlags: Connection pool flags for Cloud SQL instances managed +// connection pool configuration. +type ConnectionPoolFlags struct { + // Name: Required. The name of the flag. + Name string `json:"name,omitempty"` + // Value: Required. The value of the flag. Boolean flags are set to `on` for + // true and `off` for false. This field must be omitted if the flag doesn't + // take a value. + Value string `json:"value,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 ConnectionPoolFlags) MarshalJSON() ([]byte, error) { + type NoMethod ConnectionPoolFlags + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataCacheConfig: Data cache configurations. type DataCacheConfig struct { // DataCacheEnabled: Whether data cache is enabled for the instance. @@ -1314,6 +1574,7 @@ type DatabaseInstance struct { // "ON_PREMISES_INSTANCE" - An instance running on the customer's premises // that is not managed by Cloud SQL. // "READ_REPLICA_INSTANCE" - A Cloud SQL instance acting as a read-replica. + // "READ_POOL_INSTANCE" - CloudSQL read pool. InstanceType string `json:"instanceType,omitempty"` // IpAddresses: The assigned IP addresses for the instance. IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` @@ -1331,6 +1592,11 @@ type DatabaseInstance struct { MaxDiskSize int64 `json:"maxDiskSize,omitempty,string"` // Name: Name of the Cloud SQL instance. This does not include the project ID. Name string `json:"name,omitempty"` + // NodeCount: The number of nodes in a read pool. + NodeCount int64 `json:"nodeCount,omitempty"` + // Nodes: Output only. Entries containing information about each node of the + // read pool. + Nodes []*PoolNodeConfig `json:"nodes,omitempty"` // OnPremisesConfiguration: Configuration specific to on-premises instances. OnPremisesConfiguration *OnPremisesConfiguration `json:"onPremisesConfiguration,omitempty"` // OutOfDiskReport: This field represents the report generated by the proactive @@ -1409,6 +1675,8 @@ type DatabaseInstance struct { // "FAILED" - The creation of the instance failed or a fatal error occurred // during maintenance. // "ONLINE_MAINTENANCE" - Deprecated + // "REPAIRING" - (Applicable to read pool nodes only.) The read pool node + // needs to be repaired. The database might be unavailable. State string `json:"state,omitempty"` // SuspensionReason: If the instance state is SUSPENDED, the reason for the // suspension. @@ -2189,6 +2457,13 @@ type Flag struct { // Express. // "SQLSERVER_2022_WEB" - The database version is SQL Server 2022 Web. AppliesTo []string `json:"appliesTo,omitempty"` + // FlagScope: Scope of flag. + // + // Possible values: + // "SQL_FLAG_SCOPE_UNSPECIFIED" - Assume database flags if unspecified + // "SQL_FLAG_SCOPE_DATABASE" - database flags + // "SQL_FLAG_SCOPE_CONNECTION_POOL" - connection pool configuration flags + FlagScope string `json:"flagScope,omitempty"` // InBeta: Whether or not the flag is considered in beta. InBeta bool `json:"inBeta,omitempty"` // Kind: This is always `sql#flag`. @@ -2200,6 +2475,12 @@ type Flag struct { // Name: This is the name of the flag. Flag names always use underscores, not // hyphens, for example: `max_allowed_packet` Name string `json:"name,omitempty"` + // RecommendedIntValue: Recommended flag value in integer format for UI + // display. + RecommendedIntValue int64 `json:"recommendedIntValue,omitempty,string"` + // RecommendedStringValue: Recommended flag value in string format for UI + // display. + RecommendedStringValue string `json:"recommendedStringValue,omitempty"` // RequiresRestart: Indicates whether changing this flag will trigger a // database restart. Only applicable to Second Generation instances. RequiresRestart bool `json:"requiresRestart,omitempty"` @@ -3599,6 +3880,9 @@ type Operation struct { // "MANAGE_BACKUP" - Changes the BackupTier of a Cloud SQL instance. // "ENHANCED_BACKUP" - Creates a backup for an Enhanced BackupTier Cloud SQL // instance. + // "REPAIR_READ_POOL" - Repairs entire read pool or specified nodes in the + // read pool. + // "CREATE_READ_POOL" - Creates a Cloud SQL read pool instance. OperationType string `json:"operationType,omitempty"` // SelfLink: The URI of this resource. SelfLink string `json:"selfLink,omitempty"` @@ -3853,6 +4137,54 @@ func (s PerformDiskShrinkContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PoolNodeConfig: Details of a single node of a read pool. +type PoolNodeConfig struct { + // DnsName: Output only. The DNS name of the node. + DnsName string `json:"dnsName,omitempty"` + // DnsNames: Output only. The list of DNS names used by this node. + DnsNames []*DnsNameMapping `json:"dnsNames,omitempty"` + // GceZone: Output only. The serving zone of the node. + GceZone string `json:"gceZone,omitempty"` + // IpAddresses: Output only. Mappings containing IP addresses that can be used + // to connect to the node. + IpAddresses []*IpMapping `json:"ipAddresses,omitempty"` + // Name: Output only. The name of the node, to be used for retrieving metrics + // and logs for the node. + Name string `json:"name,omitempty"` + // State: Output only. The current state of the node. + // + // Possible values: + // "SQL_INSTANCE_STATE_UNSPECIFIED" - The state of the instance is unknown. + // "RUNNABLE" - The instance is running, or has been stopped by owner. + // "SUSPENDED" - The instance is not available, for example due to problems + // with billing. + // "PENDING_DELETE" - The instance is being deleted. + // "PENDING_CREATE" - The instance is being created. + // "MAINTENANCE" - The instance is down for maintenance. + // "FAILED" - The creation of the instance failed or a fatal error occurred + // during maintenance. + // "ONLINE_MAINTENANCE" - Deprecated + // "REPAIRING" - (Applicable to read pool nodes only.) The read pool node + // needs to be repaired. The database might be unavailable. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "DnsName") 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. "DnsName") 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 PoolNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod PoolNodeConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // PscAutoConnectionConfig: Settings for an automatically-setup Private Service // Connect consumer endpoint that is used to connect to a Cloud SQL instance. type PscAutoConnectionConfig struct { @@ -4182,6 +4514,9 @@ type Settings struct { BackupConfiguration *BackupConfiguration `json:"backupConfiguration,omitempty"` // Collation: The name of server Instance collation. Collation string `json:"collation,omitempty"` + // ConnectionPoolConfig: Optional. The managed connection pooling configuration + // for the instance. + ConnectionPoolConfig *ConnectionPoolConfig `json:"connectionPoolConfig,omitempty"` // ConnectorEnforcement: Specifies if connections must use Cloud SQL // connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL // instances can be connected without Cloud SQL Connectors) and `REQUIRED` @@ -4205,6 +4540,14 @@ type Settings struct { CrashSafeReplicationEnabled bool `json:"crashSafeReplicationEnabled,omitempty"` // DataCacheConfig: Configuration for data cache. DataCacheConfig *DataCacheConfig `json:"dataCacheConfig,omitempty"` + // DataDiskProvisionedIops: Optional. Provisioned number of I/O operations per + // second for the data disk. This field is only used for hyperdisk-balanced + // disk types. + DataDiskProvisionedIops int64 `json:"dataDiskProvisionedIops,omitempty,string"` + // DataDiskProvisionedThroughput: Optional. Provisioned throughput measured in + // MiB per second for the data disk. This field is only used for + // hyperdisk-balanced disk types. + DataDiskProvisionedThroughput int64 `json:"dataDiskProvisionedThroughput,omitempty,string"` // DataDiskSizeGb: The size of data disk, in GB. The data disk size minimum is // 10GB. DataDiskSizeGb int64 `json:"dataDiskSizeGb,omitempty,string"` @@ -7390,6 +7733,20 @@ func (c *FlagsListCall) DatabaseVersion(databaseVersion string) *FlagsListCall { return c } +// FlagScope sets the optional parameter "flagScope": Specify the scope of +// flags to be returned by SqlFlagsListService. Return list of database flags +// if unspecified. +// +// Possible values: +// +// "SQL_FLAG_SCOPE_UNSPECIFIED" - Assume database flags if unspecified +// "SQL_FLAG_SCOPE_DATABASE" - database flags +// "SQL_FLAG_SCOPE_CONNECTION_POOL" - connection pool configuration flags +func (c *FlagsListCall) FlagScope(flagScope string) *FlagsListCall { + c.urlParams_.Set("flagScope", flagScope) + 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/storage/v1/storage-api.json b/storage/v1/storage-api.json index 1a550aa73a..25602e2258 100644 --- a/storage/v1/storage-api.json +++ b/storage/v1/storage-api.json @@ -27,11 +27,106 @@ "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/storage/docs/json_api/", "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.eu.rep.googleapis.com/", + "location": "eu" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, { "description": "Regional Endpoint", "endpointUrl": "https://storage.europe-west3.rep.googleapis.com/", "location": "europe-west3" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west4.rep.googleapis.com/", + "location": "europe-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west6.rep.googleapis.com/", + "location": "europe-west6" + }, { "description": "Regional Endpoint", "endpointUrl": "https://storage.europe-west8.rep.googleapis.com/", @@ -42,11 +137,31 @@ "endpointUrl": "https://storage.europe-west9.rep.googleapis.com/", "location": "europe-west9" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, { "description": "Regional Endpoint", "endpointUrl": "https://storage.me-central2.rep.googleapis.com/", "location": "me-central2" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.me-west1.rep.googleapis.com/", + "location": "me-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.us.rep.googleapis.com/", + "location": "us" + }, { "description": "Regional Endpoint", "endpointUrl": "https://storage.us-central1.rep.googleapis.com/", @@ -93,7 +208,7 @@ "location": "us-west4" } ], - "etag": "\"323434373038373139383836363433393338\"", + "etag": "\"363938303832303939373531303639383731\"", "icons": { "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png", "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png" @@ -4364,7 +4479,7 @@ } } }, - "revision": "20250224", + "revision": "20250312", "rootUrl": "https://storage.googleapis.com/", "schemas": { "AdvanceRelocateBucketOperationRequest": { diff --git a/tagmanager/v1/tagmanager-api.json b/tagmanager/v1/tagmanager-api.json index 09f0106cb9..f2a4556aff 100644 --- a/tagmanager/v1/tagmanager-api.json +++ b/tagmanager/v1/tagmanager-api.json @@ -1932,7 +1932,7 @@ } } }, - "revision": "20230705", + "revision": "20250310", "rootUrl": "https://tagmanager.googleapis.com/", "schemas": { "Account": { @@ -1948,11 +1948,11 @@ "type": "string" }, "name": { - "description": "Account display name. @mutable tagmanager.accounts.create @mutable tagmanager.accounts.update", + "description": "Account display name.", "type": "string" }, "shareData": { - "description": "Whether the account shares data anonymously with Google and others. @mutable tagmanager.accounts.create @mutable tagmanager.accounts.update", + "description": "Whether the account shares data anonymously with Google and others.", "type": "boolean" } }, @@ -1963,12 +1963,7 @@ "id": "AccountAccess", "properties": { "permission": { - "annotations": { - "required": [ - "tagmanager.accounts.permissions.create" - ] - }, - "description": "List of Account permissions. Valid account permissions are read and manage. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "List of Account permissions. Valid account permissions are read and manage.", "items": { "enum": [ "read", @@ -1998,26 +1993,14 @@ "id": "Condition", "properties": { "parameter": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.triggers.create", - "tagmanager.accounts.containers.triggers.update" - ] - }, - "description": "A list of named parameters (key/value), depending on the condition's type. Notes: - For binary operators, include parameters named arg0 and arg1 for specifying the left and right operands, respectively. - At this time, the left operand (arg0) must be a reference to a variable. - For case-insensitive Regex matching, include a boolean parameter named ignore_case that is set to true. If not specified or set to any other value, the matching will be case sensitive. - To negate an operator, include a boolean parameter named negate boolean parameter that is set to true. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "A list of named parameters (key/value), depending on the condition's type. Notes: - For binary operators, include parameters named arg0 and arg1 for specifying the left and right operands, respectively. - At this time, the left operand (arg0) must be a reference to a variable. - For case-insensitive Regex matching, include a boolean parameter named ignore_case that is set to true. If not specified or set to any other value, the matching will be case sensitive. - To negate an operator, include a boolean parameter named negate boolean parameter that is set to true. ", "items": { "$ref": "Parameter" }, "type": "array" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.triggers.create", - "tagmanager.accounts.containers.triggers.update" - ] - }, - "description": "The type of operator for this condition. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "The type of operator for this condition.", "enum": [ "equals", "contains", @@ -2062,14 +2045,14 @@ "type": "string" }, "domainName": { - "description": "Optional list of domain names associated with the Container. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Optional list of domain names associated with the Container.", "items": { "type": "string" }, "type": "array" }, "enabledBuiltInVariable": { - "description": "List of enabled built-in variables. Valid values include: pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "List of enabled built-in variables. Valid values include: pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId.", "items": { "enum": [ "pageUrl", @@ -2294,16 +2277,11 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.create" - ] - }, - "description": "Container display name. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Container display name.", "type": "string" }, "notes": { - "description": "Container Notes. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Container Notes.", "type": "string" }, "publicId": { @@ -2311,31 +2289,15 @@ "type": "string" }, "timeZoneCountryId": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.create" - ] - }, - "description": "Container Country ID. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Container Country ID.", "type": "string" }, "timeZoneId": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.create" - ] - }, - "description": "Container Time Zone ID. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Container Time Zone ID.", "type": "string" }, "usageContext": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.create", - "tagmanager.accounts.containers.update" - ] - }, - "description": "List of Usage Contexts for the Container. Valid values include: web, android, ios. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "List of Usage Contexts for the Container. Valid values include: web, android, ios.", "items": { "enum": [ "web", @@ -2365,11 +2327,11 @@ "id": "ContainerAccess", "properties": { "containerId": { - "description": "GTM Container ID. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "GTM Container ID.", "type": "string" }, "permission": { - "description": "List of Container permissions. Valid container permissions are: read, edit, delete, publish. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "List of Container permissions. Valid container permissions are: read, edit, delete, publish.", "items": { "enum": [ "read", @@ -2438,11 +2400,11 @@ "type": "array" }, "name": { - "description": "Container version display name. @mutable tagmanager.accounts.containers.versions.update", + "description": "Container version display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this container version in the container. @mutable tagmanager.accounts.containers.versions.update", + "description": "User notes on how to apply this container version in the container.", "type": "string" }, "rule": { @@ -2585,11 +2547,11 @@ "type": "string" }, "description": { - "description": "The environment description. Can be set or changed only on USER type environments. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "The environment description. Can be set or changed only on USER type environments.", "type": "string" }, "enableDebug": { - "description": "Whether or not to enable debug by default on for the environment. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "Whether or not to enable debug by default on for the environment.", "type": "boolean" }, "environmentId": { @@ -2601,13 +2563,7 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.environments.create", - "tagmanager.accounts.containers.environments.update" - ] - }, - "description": "The environment display name. Can be set or changed only on USER type environments. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "The environment display name. Can be set or changed only on USER type environments.", "type": "string" }, "type": { @@ -2627,7 +2583,7 @@ "type": "string" }, "url": { - "description": "Default preview page url for the environment. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "Default preview page url for the environment.", "type": "string" } }, @@ -2654,13 +2610,7 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.folders.create", - "tagmanager.accounts.containers.folders.update" - ] - }, - "description": "Folder display name. @mutable tagmanager.accounts.containers.folders.create @mutable tagmanager.accounts.containers.folders.update", + "description": "Folder display name.", "type": "string" } }, @@ -2840,14 +2790,14 @@ "type": "string" }, "disablingRuleId": { - "description": "For mobile containers only: A list of rule IDs for disabling conditional macros; the macro is enabled if one of the enabling rules is true while all the disabling rules are false. Treated as an unordered set. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "For mobile containers only: A list of rule IDs for disabling conditional macros; the macro is enabled if one of the enabling rules is true while all the disabling rules are false. Treated as an unordered set.", "items": { "type": "string" }, "type": "array" }, "enablingRuleId": { - "description": "For mobile containers only: A list of rule IDs for enabling conditional macros; the macro is enabled if one of the enabling rules is true while all the disabling rules are false. Treated as an unordered set. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "For mobile containers only: A list of rule IDs for enabling conditional macros; the macro is enabled if one of the enabling rules is true while all the disabling rules are false. Treated as an unordered set.", "items": { "type": "string" }, @@ -2862,15 +2812,15 @@ "type": "string" }, "name": { - "description": "Macro display name. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "Macro display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this macro in the container. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "User notes on how to apply this macro in the container.", "type": "string" }, "parameter": { - "description": "The macro's parameters. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "The macro's parameters.", "items": { "$ref": "Parameter" }, @@ -2881,17 +2831,17 @@ "type": "string" }, "scheduleEndMs": { - "description": "The end timestamp in milliseconds to schedule a macro. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "The end timestamp in milliseconds to schedule a macro.", "format": "int64", "type": "string" }, "scheduleStartMs": { - "description": "The start timestamp in milliseconds to schedule a macro. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "The start timestamp in milliseconds to schedule a macro.", "format": "int64", "type": "string" }, "type": { - "description": "GTM Macro Type. @mutable tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.containers.macros.update", + "description": "GTM Macro Type.", "type": "string" } }, @@ -2902,35 +2852,25 @@ "id": "Parameter", "properties": { "key": { - "description": "The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values.", "type": "string" }, "list": { - "description": "This list parameter's parameters (keys will be ignored). @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "This list parameter's parameters (keys will be ignored).", "items": { "$ref": "Parameter" }, "type": "array" }, "map": { - "description": "This map parameter's parameters (must have keys; keys must be unique). @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "This map parameter's parameters (must have keys; keys must be unique).", "items": { "$ref": "Parameter" }, "type": "array" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.tags.create", - "tagmanager.accounts.containers.tags.update", - "tagmanager.accounts.containers.triggers.create", - "tagmanager.accounts.containers.triggers.update", - "tagmanager.accounts.containers.variables.create", - "tagmanager.accounts.containers.variables.update" - ] - }, - "description": "The parameter type. Valid values are: - boolean: The value represents a boolean, represented as 'true' or 'false' - integer: The value represents a 64-bit signed integer value, in base 10 - list: A list of parameters should be specified - map: A map of parameters should be specified - template: The value represents any text; this can include variable references (even variable references that might return non-string types) - trigger_reference: The value represents a trigger, represented as the trigger id - tag_reference: The value represents a tag, represented as the tag name @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "The parameter type. Valid values are: - boolean: The value represents a boolean, represented as 'true' or 'false' - integer: The value represents a 64-bit signed integer value, in base 10 - list: A list of parameters should be specified - map: A map of parameters should be specified - template: The value represents any text; this can include variable references (even variable references that might return non-string types) - trigger_reference: The value represents a trigger, represented as the trigger id - tag_reference: The value represents a tag, represented as the tag name ", "enum": [ "template", "integer", @@ -2941,7 +2881,7 @@ "tagReference" ], "enumDescriptions": [ - "May include variable references (such as \"{{myVariable}}\").", + "May include variable references.", "", "", "", @@ -2952,7 +2892,7 @@ "type": "string" }, "value": { - "description": "A parameter's value (may contain variable references such as \"{{myVariable}}\") as appropriate to the specified type. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "A parameter's value (may contain variable references). as appropriate to the specified type.", "type": "string" } }, @@ -2982,7 +2922,7 @@ "type": "string" }, "condition": { - "description": "The list of conditions that make up this rule (implicit AND between them). @mutable tagmanager.accounts.containers.rules.create @mutable tagmanager.accounts.containers.rules.update", + "description": "The list of conditions that make up this rule (implicit AND between them).", "items": { "$ref": "Condition" }, @@ -2997,11 +2937,11 @@ "type": "string" }, "name": { - "description": "Rule display name. @mutable tagmanager.accounts.containers.rules.create @mutable tagmanager.accounts.containers.rules.update", + "description": "Rule display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this rule in the container. @mutable tagmanager.accounts.containers.rules.create @mutable tagmanager.accounts.containers.rules.update", + "description": "User notes on how to apply this rule in the container.", "type": "string" }, "ruleId": { @@ -3035,14 +2975,14 @@ }, "blockingRuleId": { "deprecated": true, - "description": "Blocking rule IDs. If any of the listed rules evaluate to true, the tag will not fire. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "Blocking rule IDs. If any of the listed rules evaluate to true, the tag will not fire.", "items": { "type": "string" }, "type": "array" }, "blockingTriggerId": { - "description": "Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag will not fire. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag will not fire.", "items": { "type": "string" }, @@ -3058,39 +2998,33 @@ }, "firingRuleId": { "deprecated": true, - "description": "Firing rule IDs. A tag will fire when any of the listed rules are true and all of its blockingRuleIds (if any specified) are false. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "Firing rule IDs. A tag will fire when any of the listed rules are true and all of its blockingRuleIds (if any specified) are false.", "items": { "type": "string" }, "type": "array" }, "firingTriggerId": { - "description": "Firing trigger IDs. A tag will fire when any of the listed triggers are true and all of its blockingTriggerIds (if any specified) are false. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "Firing trigger IDs. A tag will fire when any of the listed triggers are true and all of its blockingTriggerIds (if any specified) are false.", "items": { "type": "string" }, "type": "array" }, "liveOnly": { - "description": "If set to true, this tag will only fire in the live environment (e.g. not in preview or debug mode). @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "If set to true, this tag will only fire in the live environment (e.g. not in preview or debug mode).", "type": "boolean" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.tags.create", - "tagmanager.accounts.containers.tags.update" - ] - }, - "description": "Tag display name. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "Tag display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this tag in the container. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "User notes on how to apply this tag in the container.", "type": "string" }, "parameter": { - "description": "The tag's parameters. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "The tag's parameters.", "items": { "$ref": "Parameter" }, @@ -3101,20 +3035,20 @@ "type": "string" }, "paused": { - "description": "True if the tag is paused. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "True if the tag is paused.", "type": "boolean" }, "priority": { "$ref": "Parameter", - "description": "User defined numeric priority of the tag. Tags are fired asynchronously in order of priority. Tags with higher numeric value fire first. A tag's priority can be a positive or negative value. The default value is 0. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update" + "description": "User defined numeric priority of the tag. Tags are fired asynchronously in order of priority. Tags with higher numeric value fire first. A tag's priority can be a positive or negative value. The default value is 0." }, "scheduleEndMs": { - "description": "The end timestamp in milliseconds to schedule a tag. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "The end timestamp in milliseconds to schedule a tag.", "format": "int64", "type": "string" }, "scheduleStartMs": { - "description": "The start timestamp in milliseconds to schedule a tag. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "The start timestamp in milliseconds to schedule a tag.", "format": "int64", "type": "string" }, @@ -3151,12 +3085,7 @@ "type": "array" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.tags.create" - ] - }, - "description": "GTM Tag Type. @mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.update", + "description": "GTM Tag Type.", "type": "string" } }, @@ -3185,7 +3114,7 @@ "type": "string" }, "autoEventFilter": { - "description": "Used in the case of auto event tracking. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "Used in the case of auto event tracking.", "items": { "$ref": "Condition" }, @@ -3193,7 +3122,7 @@ }, "checkValidation": { "$ref": "Parameter", - "description": "Whether or not we should only fire tags if the form submit or link click event is not cancelled by some other event handler (e.g. because of validation). Only valid for Form Submission and Link Click triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Whether or not we should only fire tags if the form submit or link click event is not cancelled by some other event handler (e.g. because of validation). Only valid for Form Submission and Link Click triggers." }, "containerId": { "description": "GTM Container ID.", @@ -3201,10 +3130,10 @@ }, "continuousTimeMinMilliseconds": { "$ref": "Parameter", - "description": "A visibility trigger minimum continuous visible time (in milliseconds). Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "A visibility trigger minimum continuous visible time (in milliseconds). Only valid for AMP Visibility trigger." }, "customEventFilter": { - "description": "Used in the case of custom event, which is fired iff all Conditions are true. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "Used in the case of custom event, which is fired iff all Conditions are true.", "items": { "$ref": "Condition" }, @@ -3212,10 +3141,10 @@ }, "eventName": { "$ref": "Parameter", - "description": "Name of the GTM event that is fired. Only valid for Timer triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Name of the GTM event that is fired. Only valid for Timer triggers." }, "filter": { - "description": "The trigger will only fire iff all Conditions are true. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "The trigger will only fire iff all Conditions are true.", "items": { "$ref": "Condition" }, @@ -3227,36 +3156,30 @@ }, "horizontalScrollPercentageList": { "$ref": "Parameter", - "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled horizontally. Only valid for AMP scroll triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled horizontally. Only valid for AMP scroll triggers." }, "interval": { "$ref": "Parameter", - "description": "Time between triggering recurring Timer Events (in milliseconds). Only valid for Timer triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Time between triggering recurring Timer Events (in milliseconds). Only valid for Timer triggers." }, "intervalSeconds": { "$ref": "Parameter", - "description": "Time between Timer Events to fire (in seconds). Only valid for AMP Timer trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Time between Timer Events to fire (in seconds). Only valid for AMP Timer trigger." }, "limit": { "$ref": "Parameter", - "description": "Limit of the number of GTM events this Timer Trigger will fire. If no limit is set, we will continue to fire GTM events until the user leaves the page. Only valid for Timer triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Limit of the number of GTM events this Timer Trigger will fire. If no limit is set, we will continue to fire GTM events until the user leaves the page. Only valid for Timer triggers." }, "maxTimerLengthSeconds": { "$ref": "Parameter", - "description": "Max time to fire Timer Events (in seconds). Only valid for AMP Timer trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Max time to fire Timer Events (in seconds). Only valid for AMP Timer trigger." }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.triggers.create", - "tagmanager.accounts.containers.triggers.update" - ] - }, - "description": "Trigger display name. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "Trigger display name.", "type": "string" }, "parameter": { - "description": "Additional parameters. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "Additional parameters.", "items": { "$ref": "Parameter" }, @@ -3268,23 +3191,18 @@ }, "selector": { "$ref": "Parameter", - "description": "A click trigger CSS selector (i.e. \"a\", \"button\" etc.). Only valid for AMP Click trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "A click trigger CSS selector (i.e. \"a\", \"button\" etc.). Only valid for AMP Click trigger." }, "totalTimeMinMilliseconds": { "$ref": "Parameter", - "description": "A visibility trigger minimum total visible time (in milliseconds). Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "A visibility trigger minimum total visible time (in milliseconds). Only valid for AMP Visibility trigger." }, "triggerId": { "description": "The Trigger ID uniquely identifies the GTM Trigger.", "type": "string" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.triggers.create" - ] - }, - "description": "Defines the data layer event that causes this trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update", + "description": "Defines the data layer event that causes this trigger.", "enum": [ "pageview", "domReady", @@ -3331,31 +3249,31 @@ }, "uniqueTriggerId": { "$ref": "Parameter", - "description": "Globally unique id of the trigger that auto-generates this (a Form Submit, Link Click or Timer listener) if any. Used to make incompatible auto-events work together with trigger filtering based on trigger ids. This value is populated during output generation since the tags implied by triggers don't exist until then. Only valid for Form Submit, Link Click and Timer triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Globally unique id of the trigger that auto-generates this (a Form Submit, Link Click or Timer listener) if any. Used to make incompatible auto-events work together with trigger filtering based on trigger ids. This value is populated during output generation since the tags implied by triggers don't exist until then. Only valid for Form Submit, Link Click and Timer triggers." }, "verticalScrollPercentageList": { "$ref": "Parameter", - "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled vertically. Only valid for AMP scroll triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled vertically. Only valid for AMP scroll triggers." }, "visibilitySelector": { "$ref": "Parameter", - "description": "A visibility trigger CSS selector (i.e. \"#id\"). Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "A visibility trigger CSS selector (i.e. \"#id\"). Only valid for AMP Visibility trigger." }, "visiblePercentageMax": { "$ref": "Parameter", - "description": "A visibility trigger maximum percent visibility. Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "A visibility trigger maximum percent visibility. Only valid for AMP Visibility trigger." }, "visiblePercentageMin": { "$ref": "Parameter", - "description": "A visibility trigger minimum percent visibility. Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "A visibility trigger minimum percent visibility. Only valid for AMP Visibility trigger." }, "waitForTags": { "$ref": "Parameter", - "description": "Whether or not we should delay the form submissions or link opening until all of the tags have fired (by preventing the default action and later simulating the default action). Only valid for Form Submission and Link Click triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "Whether or not we should delay the form submissions or link opening until all of the tags have fired (by preventing the default action and later simulating the default action). Only valid for Form Submission and Link Click triggers." }, "waitForTagsTimeout": { "$ref": "Parameter", - "description": "How long to wait (in milliseconds) for tags to fire when 'waits_for_tags' above evaluates to true. Only valid for Form Submission and Link Click triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.accounts.containers.triggers.update" + "description": "How long to wait (in milliseconds) for tags to fire when 'waits_for_tags' above evaluates to true. Only valid for Form Submission and Link Click triggers." } }, "type": "object" @@ -3366,31 +3284,21 @@ "properties": { "accountAccess": { "$ref": "AccountAccess", - "annotations": { - "required": [ - "tagmanager.accounts.permissions.create" - ] - }, - "description": "GTM Account access permissions. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update" + "description": "GTM Account access permissions." }, "accountId": { "description": "GTM Account ID.", "type": "string" }, "containerAccess": { - "description": "GTM Container access permissions. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "GTM Container access permissions.", "items": { "$ref": "ContainerAccess" }, "type": "array" }, "emailAddress": { - "annotations": { - "required": [ - "tagmanager.accounts.permissions.create" - ] - }, - "description": "User's email address. @mutable tagmanager.accounts.permissions.create", + "description": "User's email address.", "type": "string" }, "permissionId": { @@ -3413,14 +3321,14 @@ "type": "string" }, "disablingTriggerId": { - "description": "For mobile containers only: A list of trigger IDs for disabling conditional variables; the variable is enabled if one of the enabling trigger is true while all the disabling trigger are false. Treated as an unordered set. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "For mobile containers only: A list of trigger IDs for disabling conditional variables; the variable is enabled if one of the enabling trigger is true while all the disabling trigger are false. Treated as an unordered set.", "items": { "type": "string" }, "type": "array" }, "enablingTriggerId": { - "description": "For mobile containers only: A list of trigger IDs for enabling conditional variables; the variable is enabled if one of the enabling triggers is true while all the disabling triggers are false. Treated as an unordered set. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "For mobile containers only: A list of trigger IDs for enabling conditional variables; the variable is enabled if one of the enabling triggers is true while all the disabling triggers are false. Treated as an unordered set.", "items": { "type": "string" }, @@ -3431,21 +3339,15 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.variables.create", - "tagmanager.accounts.containers.variables.update" - ] - }, - "description": "Variable display name. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "Variable display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this variable in the container. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "User notes on how to apply this variable in the container.", "type": "string" }, "parameter": { - "description": "The variable's parameters. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "The variable's parameters.", "items": { "$ref": "Parameter" }, @@ -3456,23 +3358,17 @@ "type": "string" }, "scheduleEndMs": { - "description": "The end timestamp in milliseconds to schedule a variable. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "The end timestamp in milliseconds to schedule a variable.", "format": "int64", "type": "string" }, "scheduleStartMs": { - "description": "The start timestamp in milliseconds to schedule a variable. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "The start timestamp in milliseconds to schedule a variable.", "format": "int64", "type": "string" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.variables.create", - "tagmanager.accounts.containers.variables.update" - ] - }, - "description": "GTM Variable Type. @mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.containers.variables.update", + "description": "GTM Variable Type.", "type": "string" }, "variableId": { diff --git a/tagmanager/v1/tagmanager-gen.go b/tagmanager/v1/tagmanager-gen.go index 7e3cf66a1f..a7b0645d0c 100644 --- a/tagmanager/v1/tagmanager-gen.go +++ b/tagmanager/v1/tagmanager-gen.go @@ -334,12 +334,10 @@ type Account struct { // Fingerprint: The fingerprint of the GTM Account as computed at storage time. // This value is recomputed whenever the account is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Account display name. @mutable tagmanager.accounts.create @mutable - // tagmanager.accounts.update + // Name: Account display name. Name string `json:"name,omitempty"` // ShareData: Whether the account shares data anonymously with Google and - // others. @mutable tagmanager.accounts.create @mutable - // tagmanager.accounts.update + // others. ShareData bool `json:"shareData,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -365,8 +363,7 @@ func (s Account) MarshalJSON() ([]byte, error) { // AccountAccess: Defines the Google Tag Manager Account access permissions. type AccountAccess struct { // Permission: List of Account permissions. Valid account permissions are read - // and manage. @mutable tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // and manage. // // Possible values: // "read" @@ -404,12 +401,8 @@ type Condition struct { // ignore_case that is set to true. If not specified or set to any other value, // the matching will be case sensitive. - To negate an operator, include a // boolean parameter named negate boolean parameter that is set to true. - // @mutable tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update Parameter []*Parameter `json:"parameter,omitempty"` - // Type: The type of operator for this condition. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // Type: The type of operator for this condition. // // Possible values: // "equals" @@ -449,8 +442,6 @@ type Container struct { // ContainerId: The Container ID uniquely identifies the GTM Container. ContainerId string `json:"containerId,omitempty"` // DomainName: Optional list of domain names associated with the Container. - // @mutable tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update DomainName []string `json:"domainName,omitempty"` // EnabledBuiltInVariable: List of enabled built-in variables. Valid values // include: pageUrl, pageHostname, pagePath, referrer, event, clickElement, @@ -458,8 +449,7 @@ type Container struct { // formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, // errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, // oldHistoryState, historySource, containerVersion, debugMode, randomNumber, - // containerId. @mutable tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update + // containerId. // // Possible values: // "pageUrl" @@ -571,25 +561,18 @@ type Container struct { // Fingerprint: The fingerprint of the GTM Container as computed at storage // time. This value is recomputed whenever the account is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Container display name. @mutable tagmanager.accounts.containers.create - // @mutable tagmanager.accounts.containers.update + // Name: Container display name. Name string `json:"name,omitempty"` - // Notes: Container Notes. @mutable tagmanager.accounts.containers.create - // @mutable tagmanager.accounts.containers.update + // Notes: Container Notes. Notes string `json:"notes,omitempty"` // PublicId: Container Public ID. PublicId string `json:"publicId,omitempty"` - // TimeZoneCountryId: Container Country ID. @mutable - // tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update + // TimeZoneCountryId: Container Country ID. TimeZoneCountryId string `json:"timeZoneCountryId,omitempty"` - // TimeZoneId: Container Time Zone ID. @mutable - // tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update + // TimeZoneId: Container Time Zone ID. TimeZoneId string `json:"timeZoneId,omitempty"` // UsageContext: List of Usage Contexts for the Container. Valid values - // include: web, android, ios. @mutable tagmanager.accounts.containers.create - // @mutable tagmanager.accounts.containers.update + // include: web, android, ios. // // Possible values: // "web" @@ -623,13 +606,10 @@ func (s Container) MarshalJSON() ([]byte, error) { // ContainerAccess: Defines the Google Tag Manager Container access // permissions. type ContainerAccess struct { - // ContainerId: GTM Container ID. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` // Permission: List of Container permissions. Valid container permissions are: - // read, edit, delete, publish. @mutable tagmanager.accounts.permissions.create - // @mutable tagmanager.accounts.permissions.update + // read, edit, delete, publish. // // Possible values: // "read" @@ -678,11 +658,9 @@ type ContainerVersion struct { Folder []*Folder `json:"folder,omitempty"` // Macro: The macros in the container that this version was taken from. Macro []*Macro `json:"macro,omitempty"` - // Name: Container version display name. @mutable - // tagmanager.accounts.containers.versions.update + // Name: Container version display name. Name string `json:"name,omitempty"` // Notes: User notes on how to apply this container version in the container. - // @mutable tagmanager.accounts.containers.versions.update Notes string `json:"notes,omitempty"` // Rule: The rules in the container that this version was taken from. Rule []*Rule `json:"rule,omitempty"` @@ -825,13 +803,10 @@ type Environment struct { ContainerId string `json:"containerId,omitempty"` ContainerVersionId string `json:"containerVersionId,omitempty"` // Description: The environment description. Can be set or changed only on USER - // type environments. @mutable - // tagmanager.accounts.containers.environments.create @mutable - // tagmanager.accounts.containers.environments.update + // type environments. Description string `json:"description,omitempty"` // EnableDebug: Whether or not to enable debug by default on for the - // environment. @mutable tagmanager.accounts.containers.environments.create - // @mutable tagmanager.accounts.containers.environments.update + // environment. EnableDebug bool `json:"enableDebug,omitempty"` // EnvironmentId: GTM Environment ID uniquely identifies the GTM Environment. EnvironmentId string `json:"environmentId,omitempty"` @@ -839,8 +814,7 @@ type Environment struct { // time. This value is recomputed whenever the environment is modified. Fingerprint string `json:"fingerprint,omitempty"` // Name: The environment display name. Can be set or changed only on USER type - // environments. @mutable tagmanager.accounts.containers.environments.create - // @mutable tagmanager.accounts.containers.environments.update + // environments. Name string `json:"name,omitempty"` // Type: The type of this environment. // @@ -853,9 +827,7 @@ type Environment struct { // "draft" - Used for Draft environment, which points to the single draft in // the container. Type string `json:"type,omitempty"` - // Url: Default preview page url for the environment. @mutable - // tagmanager.accounts.containers.environments.create @mutable - // tagmanager.accounts.containers.environments.update + // Url: Default preview page url for the environment. Url string `json:"url,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -889,9 +861,7 @@ type Folder struct { Fingerprint string `json:"fingerprint,omitempty"` // FolderId: The Folder ID uniquely identifies the GTM Folder. FolderId string `json:"folderId,omitempty"` - // Name: Folder display name. @mutable - // tagmanager.accounts.containers.folders.create @mutable - // tagmanager.accounts.containers.folders.update + // Name: Folder display name. Name string `json:"name,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1179,44 +1149,30 @@ type Macro struct { // DisablingRuleId: For mobile containers only: A list of rule IDs for // disabling conditional macros; the macro is enabled if one of the enabling // rules is true while all the disabling rules are false. Treated as an - // unordered set. @mutable tagmanager.accounts.containers.macros.create - // @mutable tagmanager.accounts.containers.macros.update + // unordered set. DisablingRuleId []string `json:"disablingRuleId,omitempty"` // EnablingRuleId: For mobile containers only: A list of rule IDs for enabling // conditional macros; the macro is enabled if one of the enabling rules is // true while all the disabling rules are false. Treated as an unordered set. - // @mutable tagmanager.accounts.containers.macros.create @mutable - // tagmanager.accounts.containers.macros.update EnablingRuleId []string `json:"enablingRuleId,omitempty"` // Fingerprint: The fingerprint of the GTM Macro as computed at storage time. // This value is recomputed whenever the macro is modified. Fingerprint string `json:"fingerprint,omitempty"` // MacroId: The Macro ID uniquely identifies the GTM Macro. MacroId string `json:"macroId,omitempty"` - // Name: Macro display name. @mutable - // tagmanager.accounts.containers.macros.create @mutable - // tagmanager.accounts.containers.macros.update + // Name: Macro display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this macro in the container. @mutable - // tagmanager.accounts.containers.macros.create @mutable - // tagmanager.accounts.containers.macros.update + // Notes: User notes on how to apply this macro in the container. Notes string `json:"notes,omitempty"` - // Parameter: The macro's parameters. @mutable - // tagmanager.accounts.containers.macros.create @mutable - // tagmanager.accounts.containers.macros.update + // Parameter: The macro's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // ScheduleEndMs: The end timestamp in milliseconds to schedule a macro. - // @mutable tagmanager.accounts.containers.macros.create @mutable - // tagmanager.accounts.containers.macros.update ScheduleEndMs int64 `json:"scheduleEndMs,omitempty,string"` // ScheduleStartMs: The start timestamp in milliseconds to schedule a macro. - // @mutable tagmanager.accounts.containers.macros.create @mutable - // tagmanager.accounts.containers.macros.update ScheduleStartMs int64 `json:"scheduleStartMs,omitempty,string"` - // Type: GTM Macro Type. @mutable tagmanager.accounts.containers.macros.create - // @mutable tagmanager.accounts.containers.macros.update + // Type: GTM Macro Type. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "AccountId") to // unconditionally include in API requests. By default, fields with empty or @@ -1240,28 +1196,10 @@ func (s Macro) MarshalJSON() ([]byte, error) { type Parameter struct { // Key: The named key that uniquely identifies a parameter. Required for // top-level parameters, as well as map values. Ignored for list values. - // @mutable tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update Key string `json:"key,omitempty"` - // List: This list parameter's parameters (keys will be ignored). @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // List: This list parameter's parameters (keys will be ignored). List []*Parameter `json:"list,omitempty"` // Map: This map parameter's parameters (must have keys; keys must be unique). - // @mutable tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update Map []*Parameter `json:"map,omitempty"` // Type: The parameter type. Valid values are: - boolean: The value represents // a boolean, represented as 'true' or 'false' - integer: The value represents @@ -1271,15 +1209,10 @@ type Parameter struct { // references (even variable references that might return non-string types) - // trigger_reference: The value represents a trigger, represented as the // trigger id - tag_reference: The value represents a tag, represented as the - // tag name @mutable tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // tag name // // Possible values: - // "template" - May include variable references (such as "{{myVariable}}"). + // "template" - May include variable references. // "integer" // "boolean" // "list" @@ -1287,14 +1220,8 @@ type Parameter struct { // "triggerReference" // "tagReference" Type string `json:"type,omitempty"` - // Value: A parameter's value (may contain variable references such as - // "{{myVariable}}") as appropriate to the specified type. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // Value: A parameter's value (may contain variable references). as appropriate + // to the specified type. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Key") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1346,21 +1273,16 @@ type Rule struct { // AccountId: GTM Account ID. AccountId string `json:"accountId,omitempty"` // Condition: The list of conditions that make up this rule (implicit AND - // between them). @mutable tagmanager.accounts.containers.rules.create @mutable - // tagmanager.accounts.containers.rules.update + // between them). Condition []*Condition `json:"condition,omitempty"` // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` // Fingerprint: The fingerprint of the GTM Rule as computed at storage time. // This value is recomputed whenever the rule is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Rule display name. @mutable - // tagmanager.accounts.containers.rules.create @mutable - // tagmanager.accounts.containers.rules.update + // Name: Rule display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this rule in the container. @mutable - // tagmanager.accounts.containers.rules.create @mutable - // tagmanager.accounts.containers.rules.update + // Notes: User notes on how to apply this rule in the container. Notes string `json:"notes,omitempty"` // RuleId: The Rule ID uniquely identifies the GTM Rule. RuleId string `json:"ruleId,omitempty"` @@ -1412,14 +1334,10 @@ type Tag struct { // AccountId: GTM Account ID. AccountId string `json:"accountId,omitempty"` // BlockingRuleId: Blocking rule IDs. If any of the listed rules evaluate to - // true, the tag will not fire. @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // true, the tag will not fire. BlockingRuleId []string `json:"blockingRuleId,omitempty"` // BlockingTriggerId: Blocking trigger IDs. If any of the listed triggers - // evaluate to true, the tag will not fire. @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // evaluate to true, the tag will not fire. BlockingTriggerId []string `json:"blockingTriggerId,omitempty"` // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` @@ -1428,49 +1346,32 @@ type Tag struct { Fingerprint string `json:"fingerprint,omitempty"` // FiringRuleId: Firing rule IDs. A tag will fire when any of the listed rules // are true and all of its blockingRuleIds (if any specified) are false. - // @mutable tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update FiringRuleId []string `json:"firingRuleId,omitempty"` // FiringTriggerId: Firing trigger IDs. A tag will fire when any of the listed // triggers are true and all of its blockingTriggerIds (if any specified) are - // false. @mutable tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // false. FiringTriggerId []string `json:"firingTriggerId,omitempty"` // LiveOnly: If set to true, this tag will only fire in the live environment - // (e.g. not in preview or debug mode). @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // (e.g. not in preview or debug mode). LiveOnly bool `json:"liveOnly,omitempty"` - // Name: Tag display name. @mutable tagmanager.accounts.containers.tags.create - // @mutable tagmanager.accounts.containers.tags.update + // Name: Tag display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this tag in the container. @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // Notes: User notes on how to apply this tag in the container. Notes string `json:"notes,omitempty"` - // Parameter: The tag's parameters. @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // Parameter: The tag's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` - // Paused: True if the tag is paused. @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // Paused: True if the tag is paused. Paused bool `json:"paused,omitempty"` // Priority: User defined numeric priority of the tag. Tags are fired // asynchronously in order of priority. Tags with higher numeric value fire // first. A tag's priority can be a positive or negative value. The default - // value is 0. @mutable tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // value is 0. Priority *Parameter `json:"priority,omitempty"` - // ScheduleEndMs: The end timestamp in milliseconds to schedule a tag. @mutable - // tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update + // ScheduleEndMs: The end timestamp in milliseconds to schedule a tag. ScheduleEndMs int64 `json:"scheduleEndMs,omitempty,string"` // ScheduleStartMs: The start timestamp in milliseconds to schedule a tag. - // @mutable tagmanager.accounts.containers.tags.create @mutable - // tagmanager.accounts.containers.tags.update ScheduleStartMs int64 `json:"scheduleStartMs,omitempty,string"` // SetupTag: The list of setup tags. Currently we only allow one. SetupTag []*SetupTag `json:"setupTag,omitempty"` @@ -1487,8 +1388,7 @@ type Tag struct { TagId string `json:"tagId,omitempty"` // TeardownTag: The list of teardown tags. Currently we only allow one. TeardownTag []*TeardownTag `json:"teardownTag,omitempty"` - // Type: GTM Tag Type. @mutable tagmanager.accounts.containers.tags.create - // @mutable tagmanager.accounts.containers.tags.update + // Type: GTM Tag Type. Type string `json:"type,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1540,90 +1440,61 @@ func (s TeardownTag) MarshalJSON() ([]byte, error) { type Trigger struct { // AccountId: GTM Account ID. AccountId string `json:"accountId,omitempty"` - // AutoEventFilter: Used in the case of auto event tracking. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // AutoEventFilter: Used in the case of auto event tracking. AutoEventFilter []*Condition `json:"autoEventFilter,omitempty"` // CheckValidation: Whether or not we should only fire tags if the form submit // or link click event is not cancelled by some other event handler (e.g. // because of validation). Only valid for Form Submission and Link Click - // triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // triggers. CheckValidation *Parameter `json:"checkValidation,omitempty"` // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` // ContinuousTimeMinMilliseconds: A visibility trigger minimum continuous // visible time (in milliseconds). Only valid for AMP Visibility trigger. - // @mutable tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update ContinuousTimeMinMilliseconds *Parameter `json:"continuousTimeMinMilliseconds,omitempty"` // CustomEventFilter: Used in the case of custom event, which is fired iff all - // Conditions are true. @mutable tagmanager.accounts.containers.triggers.create - // @mutable tagmanager.accounts.containers.triggers.update + // Conditions are true. CustomEventFilter []*Condition `json:"customEventFilter,omitempty"` // EventName: Name of the GTM event that is fired. Only valid for Timer - // triggers. @mutable tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // triggers. EventName *Parameter `json:"eventName,omitempty"` - // Filter: The trigger will only fire iff all Conditions are true. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // Filter: The trigger will only fire iff all Conditions are true. Filter []*Condition `json:"filter,omitempty"` // Fingerprint: The fingerprint of the GTM Trigger as computed at storage time. // This value is recomputed whenever the trigger is modified. Fingerprint string `json:"fingerprint,omitempty"` // HorizontalScrollPercentageList: List of integer percentage values for scroll // triggers. The trigger will fire when each percentage is reached when the - // view is scrolled horizontally. Only valid for AMP scroll triggers. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // view is scrolled horizontally. Only valid for AMP scroll triggers. HorizontalScrollPercentageList *Parameter `json:"horizontalScrollPercentageList,omitempty"` // Interval: Time between triggering recurring Timer Events (in milliseconds). - // Only valid for Timer triggers. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // Only valid for Timer triggers. Interval *Parameter `json:"interval,omitempty"` // IntervalSeconds: Time between Timer Events to fire (in seconds). Only valid - // for AMP Timer trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // for AMP Timer trigger. IntervalSeconds *Parameter `json:"intervalSeconds,omitempty"` // Limit: Limit of the number of GTM events this Timer Trigger will fire. If no // limit is set, we will continue to fire GTM events until the user leaves the - // page. Only valid for Timer triggers. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // page. Only valid for Timer triggers. Limit *Parameter `json:"limit,omitempty"` // MaxTimerLengthSeconds: Max time to fire Timer Events (in seconds). Only - // valid for AMP Timer trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // valid for AMP Timer trigger. MaxTimerLengthSeconds *Parameter `json:"maxTimerLengthSeconds,omitempty"` - // Name: Trigger display name. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // Name: Trigger display name. Name string `json:"name,omitempty"` - // Parameter: Additional parameters. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Parameter: Additional parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // Selector: A click trigger CSS selector (i.e. "a", "button" etc.). Only valid - // for AMP Click trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // for AMP Click trigger. Selector *Parameter `json:"selector,omitempty"` // TotalTimeMinMilliseconds: A visibility trigger minimum total visible time - // (in milliseconds). Only valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // (in milliseconds). Only valid for AMP Visibility trigger. TotalTimeMinMilliseconds *Parameter `json:"totalTimeMinMilliseconds,omitempty"` // TriggerId: The Trigger ID uniquely identifies the GTM Trigger. TriggerId string `json:"triggerId,omitempty"` - // Type: Defines the data layer event that causes this trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // Type: Defines the data layer event that causes this trigger. // // Possible values: // "pageview" @@ -1651,41 +1522,29 @@ type Trigger struct { // incompatible auto-events work together with trigger filtering based on // trigger ids. This value is populated during output generation since the tags // implied by triggers don't exist until then. Only valid for Form Submit, Link - // Click and Timer triggers. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // Click and Timer triggers. UniqueTriggerId *Parameter `json:"uniqueTriggerId,omitempty"` // VerticalScrollPercentageList: List of integer percentage values for scroll // triggers. The trigger will fire when each percentage is reached when the - // view is scrolled vertically. Only valid for AMP scroll triggers. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // view is scrolled vertically. Only valid for AMP scroll triggers. VerticalScrollPercentageList *Parameter `json:"verticalScrollPercentageList,omitempty"` // VisibilitySelector: A visibility trigger CSS selector (i.e. "#id"). Only - // valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // valid for AMP Visibility trigger. VisibilitySelector *Parameter `json:"visibilitySelector,omitempty"` // VisiblePercentageMax: A visibility trigger maximum percent visibility. Only - // valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // valid for AMP Visibility trigger. VisiblePercentageMax *Parameter `json:"visiblePercentageMax,omitempty"` // VisiblePercentageMin: A visibility trigger minimum percent visibility. Only - // valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.triggers.create @mutable - // tagmanager.accounts.containers.triggers.update + // valid for AMP Visibility trigger. VisiblePercentageMin *Parameter `json:"visiblePercentageMin,omitempty"` // WaitForTags: Whether or not we should delay the form submissions or link // opening until all of the tags have fired (by preventing the default action // and later simulating the default action). Only valid for Form Submission and - // Link Click triggers. @mutable tagmanager.accounts.containers.triggers.create - // @mutable tagmanager.accounts.containers.triggers.update + // Link Click triggers. WaitForTags *Parameter `json:"waitForTags,omitempty"` // WaitForTagsTimeout: How long to wait (in milliseconds) for tags to fire when // 'waits_for_tags' above evaluates to true. Only valid for Form Submission and - // Link Click triggers. @mutable tagmanager.accounts.containers.triggers.create - // @mutable tagmanager.accounts.containers.triggers.update + // Link Click triggers. WaitForTagsTimeout *Parameter `json:"waitForTagsTimeout,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1710,18 +1569,13 @@ func (s Trigger) MarshalJSON() ([]byte, error) { // UserAccess: Represents a user's permissions to an account and its container. type UserAccess struct { - // AccountAccess: GTM Account access permissions. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // AccountAccess: GTM Account access permissions. AccountAccess *AccountAccess `json:"accountAccess,omitempty"` // AccountId: GTM Account ID. AccountId string `json:"accountId,omitempty"` - // ContainerAccess: GTM Container access permissions. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // ContainerAccess: GTM Container access permissions. ContainerAccess []*ContainerAccess `json:"containerAccess,omitempty"` - // EmailAddress: User's email address. @mutable - // tagmanager.accounts.permissions.create + // EmailAddress: User's email address. EmailAddress string `json:"emailAddress,omitempty"` // PermissionId: Account Permission ID. PermissionId string `json:"permissionId,omitempty"` @@ -1755,45 +1609,29 @@ type Variable struct { // DisablingTriggerId: For mobile containers only: A list of trigger IDs for // disabling conditional variables; the variable is enabled if one of the // enabling trigger is true while all the disabling trigger are false. Treated - // as an unordered set. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update + // as an unordered set. DisablingTriggerId []string `json:"disablingTriggerId,omitempty"` // EnablingTriggerId: For mobile containers only: A list of trigger IDs for // enabling conditional variables; the variable is enabled if one of the // enabling triggers is true while all the disabling triggers are false. - // Treated as an unordered set. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update + // Treated as an unordered set. EnablingTriggerId []string `json:"enablingTriggerId,omitempty"` // Fingerprint: The fingerprint of the GTM Variable as computed at storage // time. This value is recomputed whenever the variable is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Variable display name. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update + // Name: Variable display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this variable in the container. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update + // Notes: User notes on how to apply this variable in the container. Notes string `json:"notes,omitempty"` - // Parameter: The variable's parameters. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update + // Parameter: The variable's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // ScheduleEndMs: The end timestamp in milliseconds to schedule a variable. - // @mutable tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update ScheduleEndMs int64 `json:"scheduleEndMs,omitempty,string"` // ScheduleStartMs: The start timestamp in milliseconds to schedule a variable. - // @mutable tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update ScheduleStartMs int64 `json:"scheduleStartMs,omitempty,string"` - // Type: GTM Variable Type. @mutable - // tagmanager.accounts.containers.variables.create @mutable - // tagmanager.accounts.containers.variables.update + // Type: GTM Variable Type. Type string `json:"type,omitempty"` // VariableId: The Variable ID uniquely identifies the GTM Variable. VariableId string `json:"variableId,omitempty"` diff --git a/tagmanager/v2/tagmanager-api.json b/tagmanager/v2/tagmanager-api.json index 238550fa40..7fc2391df9 100644 --- a/tagmanager/v2/tagmanager-api.json +++ b/tagmanager/v2/tagmanager-api.json @@ -134,7 +134,7 @@ ], "parameters": { "path": { - "description": "GTM Account's API relative path. Example: accounts/{account_id}", + "description": "GTM Account's API relative path.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -194,7 +194,7 @@ "type": "string" }, "path": { - "description": "GTM Account's API relative path. Example: accounts/{account_id}", + "description": "GTM Account's API relative path.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -236,7 +236,7 @@ "type": "string" }, "path": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -276,7 +276,7 @@ ], "parameters": { "parent": { - "description": "GTM Account's API relative path. Example: accounts/{account_id}.", + "description": "GTM Account's API relative path.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -304,7 +304,7 @@ ], "parameters": { "path": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -326,7 +326,7 @@ ], "parameters": { "path": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -357,7 +357,7 @@ "type": "string" }, "parent": { - "description": "GTM Account's API relative path. Example: accounts/{account_id}.", + "description": "GTM Account's API relative path.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -381,12 +381,12 @@ "parameterOrder": [], "parameters": { "destinationId": { - "description": "Destination ID linked to a GTM Container, e.g. AW-123456789. Example: accounts/containers:lookup?destination_id={destination_id}. Only one of destination_id or tag_id should be set.", + "description": "Destination ID linked to a GTM Container, e.g. AW-123456789. Only one of destination_id or tag_id should be set.", "location": "query", "type": "string" }, "tagId": { - "description": "Tag ID for a GTM Container, e.g. GTM-123456789. Example: accounts/containers:lookup?tag_id={tag_id}. Only one of destination_id or tag_id should be set.", + "description": "Tag ID for a GTM Container, e.g. GTM-123456789. Only one of destination_id or tag_id should be set.", "location": "query", "type": "string" } @@ -430,7 +430,7 @@ "type": "boolean" }, "path": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -465,7 +465,7 @@ ], "parameters": { "path": { - "description": "Container snippet's API relative path. Example: accounts/{account_id}/containers/{container_id}:snippet", + "description": "Container snippet's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -496,7 +496,7 @@ "type": "string" }, "path": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -528,7 +528,7 @@ ], "parameters": { "path": { - "description": "Google Tag Destination's API relative path. Example: accounts/{account_id}/containers/{container_id}/destinations/{destination_link_id}", + "description": "Google Tag Destination's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/destinations/[^/]+$", "required": true, @@ -564,7 +564,7 @@ "type": "string" }, "parent": { - "description": "GTM parent Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM parent Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -589,7 +589,7 @@ ], "parameters": { "parent": { - "description": "GTM parent Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM parent Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -619,7 +619,7 @@ ], "parameters": { "parent": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -647,7 +647,7 @@ ], "parameters": { "path": { - "description": "GTM Environment's API relative path. Example: accounts/{account_id}/containers/{container_id}/environments/{environment_id}", + "description": "GTM Environment's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/environments/[^/]+$", "required": true, @@ -669,7 +669,7 @@ ], "parameters": { "path": { - "description": "GTM Environment's API relative path. Example: accounts/{account_id}/containers/{container_id}/environments/{environment_id}", + "description": "GTM Environment's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/environments/[^/]+$", "required": true, @@ -700,7 +700,7 @@ "type": "string" }, "parent": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -726,7 +726,7 @@ ], "parameters": { "path": { - "description": "GTM Environment's API relative path. Example: accounts/{account_id}/containers/{container_id}/environments/{environment_id}", + "description": "GTM Environment's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/environments/[^/]+$", "required": true, @@ -759,7 +759,7 @@ "type": "string" }, "path": { - "description": "GTM Environment's API relative path. Example: accounts/{account_id}/containers/{container_id}/environments/{environment_id}", + "description": "GTM Environment's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/environments/[^/]+$", "required": true, @@ -791,7 +791,7 @@ ], "parameters": { "parent": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -827,7 +827,7 @@ "type": "string" }, "parent": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -858,7 +858,7 @@ ], "parameters": { "path": { - "description": "GTM ContainerVersion's API relative path. Example: accounts/{account_id}/containers/{container_id}/versions/{version_id}", + "description": "GTM ContainerVersion's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/versions/[^/]+$", "required": true, @@ -885,7 +885,7 @@ "type": "string" }, "path": { - "description": "GTM ContainerVersion's API relative path. Example: accounts/{account_id}/containers/{container_id}/versions/{version_id}", + "description": "GTM ContainerVersion's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/versions/[^/]+$", "required": true, @@ -912,7 +912,7 @@ ], "parameters": { "parent": { - "description": "GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -943,7 +943,7 @@ "type": "string" }, "path": { - "description": "GTM ContainerVersion's API relative path. Example: accounts/{account_id}/containers/{container_id}/versions/{version_id}", + "description": "GTM ContainerVersion's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/versions/[^/]+$", "required": true, @@ -968,7 +968,7 @@ ], "parameters": { "path": { - "description": "GTM ContainerVersion's API relative path. Example: accounts/{account_id}/containers/{container_id}/versions/{version_id}", + "description": "GTM ContainerVersion's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/versions/[^/]+$", "required": true, @@ -993,7 +993,7 @@ ], "parameters": { "path": { - "description": "GTM ContainerVersion's API relative path. Example: accounts/{account_id}/containers/{container_id}/versions/{version_id}", + "description": "GTM ContainerVersion's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/versions/[^/]+$", "required": true, @@ -1023,7 +1023,7 @@ "type": "string" }, "path": { - "description": "GTM ContainerVersion's API relative path. Example: accounts/{account_id}/containers/{container_id}/versions/{version_id}", + "description": "GTM ContainerVersion's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/versions/[^/]+$", "required": true, @@ -1055,7 +1055,7 @@ ], "parameters": { "parent": { - "description": "GTM parent Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM parent Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -1083,7 +1083,7 @@ ], "parameters": { "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1111,7 +1111,7 @@ ], "parameters": { "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1133,7 +1133,7 @@ ], "parameters": { "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1159,7 +1159,7 @@ ], "parameters": { "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1190,7 +1190,7 @@ "type": "string" }, "parent": { - "description": "GTM parent Container's API relative path. Example: accounts/{account_id}/containers/{container_id}", + "description": "GTM parent Container's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+$", "required": true, @@ -1216,7 +1216,7 @@ ], "parameters": { "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1246,7 +1246,7 @@ "type": "string" }, "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1271,7 +1271,7 @@ ], "parameters": { "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1301,7 +1301,7 @@ "type": "string" }, "path": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1333,7 +1333,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1596,7 +1596,7 @@ ], "parameters": { "path": { - "description": "GTM BuiltInVariable's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/built_in_variables", + "description": "GTM BuiltInVariable's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/built_in_variables$", "required": true, @@ -1861,7 +1861,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -1887,7 +1887,7 @@ ], "parameters": { "path": { - "description": "GTM BuiltInVariable's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/built_in_variables", + "description": "GTM BuiltInVariable's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2153,7 +2153,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2181,7 +2181,7 @@ ], "parameters": { "path": { - "description": "GTM Client's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/clients/{client_id}", + "description": "GTM Client's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/clients/[^/]+$", "required": true, @@ -2203,7 +2203,7 @@ ], "parameters": { "path": { - "description": "GTM Client's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/clients/{client_id}", + "description": "GTM Client's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/clients/[^/]+$", "required": true, @@ -2234,7 +2234,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2265,7 +2265,7 @@ "type": "string" }, "path": { - "description": "GTM Client's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/clients/{client_id}", + "description": "GTM Client's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/clients/[^/]+$", "required": true, @@ -2295,7 +2295,7 @@ "type": "string" }, "path": { - "description": "GTM Client's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/clients/{client_id}", + "description": "GTM Client's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/clients/[^/]+$", "required": true, @@ -2327,7 +2327,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2355,7 +2355,7 @@ ], "parameters": { "path": { - "description": "GTM Folder's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/folders/{folder_id}", + "description": "GTM Folder's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/folders/[^/]+$", "required": true, @@ -2382,7 +2382,7 @@ "type": "string" }, "path": { - "description": "GTM Folder's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/folders/{folder_id}", + "description": "GTM Folder's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/folders/[^/]+$", "required": true, @@ -2408,7 +2408,7 @@ ], "parameters": { "path": { - "description": "GTM Folder's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/folders/{folder_id}", + "description": "GTM Folder's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/folders/[^/]+$", "required": true, @@ -2439,7 +2439,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2465,7 +2465,7 @@ ], "parameters": { "path": { - "description": "GTM Folder's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/folders/{folder_id}", + "description": "GTM Folder's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/folders/[^/]+$", "required": true, @@ -2513,7 +2513,7 @@ "type": "string" }, "path": { - "description": "GTM Folder's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/folders/{folder_id}", + "description": "GTM Folder's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/folders/[^/]+$", "required": true, @@ -2543,7 +2543,7 @@ "type": "string" }, "path": { - "description": "GTM Folder's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/folders/{folder_id}", + "description": "GTM Folder's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/folders/[^/]+$", "required": true, @@ -2575,7 +2575,7 @@ ], "parameters": { "parent": { - "description": "Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2603,7 +2603,7 @@ ], "parameters": { "path": { - "description": "Google tag config's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/gtag_config/{gtag_config_id}", + "description": "Google tag config's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/gtag_config/[^/]+$", "required": true, @@ -2625,7 +2625,7 @@ ], "parameters": { "path": { - "description": "Google tag config's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/gtag_config/{gtag_config_id}", + "description": "Google tag config's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/gtag_config/[^/]+$", "required": true, @@ -2656,7 +2656,7 @@ "type": "string" }, "parent": { - "description": "Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2687,7 +2687,7 @@ "type": "string" }, "path": { - "description": "Google tag config's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/gtag_config/{gtag_config_id}", + "description": "Google tag config's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/gtag_config/[^/]+$", "required": true, @@ -2719,7 +2719,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2747,7 +2747,7 @@ ], "parameters": { "path": { - "description": "GTM Tag's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}", + "description": "GTM Tag's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/tags/[^/]+$", "required": true, @@ -2769,7 +2769,7 @@ ], "parameters": { "path": { - "description": "GTM Tag's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}", + "description": "GTM Tag's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/tags/[^/]+$", "required": true, @@ -2800,7 +2800,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2831,7 +2831,7 @@ "type": "string" }, "path": { - "description": "GTM Tag's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}", + "description": "GTM Tag's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/tags/[^/]+$", "required": true, @@ -2861,7 +2861,7 @@ "type": "string" }, "path": { - "description": "GTM Tag's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}", + "description": "GTM Tag's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/tags/[^/]+$", "required": true, @@ -2893,7 +2893,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -2921,7 +2921,7 @@ ], "parameters": { "path": { - "description": "GTM Custom Template's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/templates/{template_id}", + "description": "GTM Custom Template's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/templates/[^/]+$", "required": true, @@ -2943,7 +2943,7 @@ ], "parameters": { "path": { - "description": "GTM Custom Template's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/templates/{template_id}", + "description": "GTM Custom Template's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/templates/[^/]+$", "required": true, @@ -2959,6 +2959,51 @@ "https://www.googleapis.com/auth/tagmanager.readonly" ] }, + "import_from_gallery": { + "description": "Imports a GTM Custom Template from Gallery.", + "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/templates:import_from_gallery", + "httpMethod": "POST", + "id": "tagmanager.accounts.containers.workspaces.templates.import_from_gallery", + "parameterOrder": [ + "parent" + ], + "parameters": { + "acknowledgePermissions": { + "description": "Must be set to true to allow Gallery template to be imported into the workspace. If this bit is false, the import operation will fail.", + "location": "query", + "type": "boolean" + }, + "galleryOwner": { + "description": "Owner of the Gallery template to import", + "location": "query", + "type": "string" + }, + "galleryRepository": { + "description": "Repository of the Gallery template to import", + "location": "query", + "type": "string" + }, + "gallerySha": { + "description": "SHA version of the Gallery template to import. Defaulted to the latest SHA version if not provided.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "GTM Workspace's API relative path.", + "location": "path", + "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "tagmanager/v2/{+parent}/templates:import_from_gallery", + "response": { + "$ref": "CustomTemplate" + }, + "scopes": [ + "https://www.googleapis.com/auth/tagmanager.edit.containers" + ] + }, "list": { "description": "Lists all GTM Templates of a GTM container workspace.", "flatPath": "tagmanager/v2/accounts/{accountsId}/containers/{containersId}/workspaces/{workspacesId}/templates", @@ -2974,7 +3019,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3005,7 +3050,7 @@ "type": "string" }, "path": { - "description": "GTM Custom Template's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/templates/{template_id}", + "description": "GTM Custom Template's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/templates/[^/]+$", "required": true, @@ -3035,7 +3080,7 @@ "type": "string" }, "path": { - "description": "GTM Custom Template's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/templates/{template_id}", + "description": "GTM Custom Template's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/templates/[^/]+$", "required": true, @@ -3067,7 +3112,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3095,7 +3140,7 @@ ], "parameters": { "path": { - "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "description": "GTM Transformation's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", "required": true, @@ -3117,7 +3162,7 @@ ], "parameters": { "path": { - "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "description": "GTM Transformation's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", "required": true, @@ -3148,7 +3193,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3179,7 +3224,7 @@ "type": "string" }, "path": { - "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "description": "GTM Transformation's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", "required": true, @@ -3209,7 +3254,7 @@ "type": "string" }, "path": { - "description": "GTM Transformation's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/transformations/{transformation_id}", + "description": "GTM Transformation's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/transformations/[^/]+$", "required": true, @@ -3241,7 +3286,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3269,7 +3314,7 @@ ], "parameters": { "path": { - "description": "GTM Trigger's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id}", + "description": "GTM Trigger's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/triggers/[^/]+$", "required": true, @@ -3291,7 +3336,7 @@ ], "parameters": { "path": { - "description": "GTM Trigger's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id}", + "description": "GTM Trigger's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/triggers/[^/]+$", "required": true, @@ -3322,7 +3367,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3353,7 +3398,7 @@ "type": "string" }, "path": { - "description": "GTM Trigger's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id}", + "description": "GTM Trigger's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/triggers/[^/]+$", "required": true, @@ -3383,7 +3428,7 @@ "type": "string" }, "path": { - "description": "GTM Trigger's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id}", + "description": "GTM Trigger's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/triggers/[^/]+$", "required": true, @@ -3415,7 +3460,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3443,7 +3488,7 @@ ], "parameters": { "path": { - "description": "GTM Variable's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}", + "description": "GTM Variable's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/variables/[^/]+$", "required": true, @@ -3465,7 +3510,7 @@ ], "parameters": { "path": { - "description": "GTM Variable's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}", + "description": "GTM Variable's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/variables/[^/]+$", "required": true, @@ -3496,7 +3541,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3527,7 +3572,7 @@ "type": "string" }, "path": { - "description": "GTM Variable's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}", + "description": "GTM Variable's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/variables/[^/]+$", "required": true, @@ -3557,7 +3602,7 @@ "type": "string" }, "path": { - "description": "GTM Variable's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}", + "description": "GTM Variable's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/variables/[^/]+$", "required": true, @@ -3589,7 +3634,7 @@ ], "parameters": { "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3617,7 +3662,7 @@ ], "parameters": { "path": { - "description": "GTM Zone's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/zones/{zone_id}", + "description": "GTM Zone's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/zones/[^/]+$", "required": true, @@ -3639,7 +3684,7 @@ ], "parameters": { "path": { - "description": "GTM Zone's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/zones/{zone_id}", + "description": "GTM Zone's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/zones/[^/]+$", "required": true, @@ -3670,7 +3715,7 @@ "type": "string" }, "parent": { - "description": "GTM Workspace's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}", + "description": "GTM Workspace's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+$", "required": true, @@ -3701,7 +3746,7 @@ "type": "string" }, "path": { - "description": "GTM Zone's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/zones/{zone_id}", + "description": "GTM Zone's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/zones/[^/]+$", "required": true, @@ -3731,7 +3776,7 @@ "type": "string" }, "path": { - "description": "GTM Zone's API relative path. Example: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/zones/{zone_id}", + "description": "GTM Zone's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/containers/[^/]+/workspaces/[^/]+/zones/[^/]+$", "required": true, @@ -3767,7 +3812,7 @@ ], "parameters": { "parent": { - "description": "GTM Account's API relative path. Example: accounts/{account_id}", + "description": "GTM Account's API relative path.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -3795,7 +3840,7 @@ ], "parameters": { "path": { - "description": "GTM UserPermission's API relative path. Example: accounts/{account_id}/user_permissions/{user_permission_id}", + "description": "GTM UserPermission's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/user_permissions/[^/]+$", "required": true, @@ -3817,7 +3862,7 @@ ], "parameters": { "path": { - "description": "GTM UserPermission's API relative path. Example: accounts/{account_id}/user_permissions/{user_permission_id}", + "description": "GTM UserPermission's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/user_permissions/[^/]+$", "required": true, @@ -3847,7 +3892,7 @@ "type": "string" }, "parent": { - "description": "GTM Account's API relative path. Example: accounts/{account_id}", + "description": "GTM Account's API relative path.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -3872,7 +3917,7 @@ ], "parameters": { "path": { - "description": "GTM UserPermission's API relative path. Example: accounts/{account_id}/user_permissions/{user_permission_id}", + "description": "GTM UserPermission's API relative path.", "location": "path", "pattern": "^accounts/[^/]+/user_permissions/[^/]+$", "required": true, @@ -3895,7 +3940,7 @@ } } }, - "revision": "20250218", + "revision": "20250310", "rootUrl": "https://tagmanager.googleapis.com/", "schemas": { "Account": { @@ -3915,7 +3960,7 @@ "type": "string" }, "name": { - "description": "Account display name. @mutable tagmanager.accounts.create @mutable tagmanager.accounts.update", + "description": "Account display name.", "type": "string" }, "path": { @@ -3923,7 +3968,7 @@ "type": "string" }, "shareData": { - "description": "Whether the account shares data anonymously with Google and others. This flag enables benchmarking by sharing your data in an anonymous form. Google will remove all identifiable information about your website, combine the data with hundreds of other anonymous sites and report aggregate trends in the benchmarking service. @mutable tagmanager.accounts.create @mutable tagmanager.accounts.update", + "description": "Whether the account shares data anonymously with Google and others. This flag enables benchmarking by sharing your data in an anonymous form. Google will remove all identifiable information about your website, combine the data with hundreds of other anonymous sites and report aggregate trends in the benchmarking service.", "type": "boolean" }, "tagManagerUrl": { @@ -3938,7 +3983,7 @@ "id": "AccountAccess", "properties": { "permission": { - "description": "Whether the user has no access, user access, or admin access to an account. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "Whether the user has no access, user access, or admin access to an account.", "enum": [ "accountPermissionUnspecified", "noAccess", @@ -3991,7 +4036,7 @@ "type": "string" }, "type": { - "description": "Type of built-in variable. @required.tagmanager.accounts.containers.workspaces.built_in_variable.update @mutable tagmanager.accounts.containers.workspaces.built_in_variable.update", + "description": "Type of built-in variable.", "enum": [ "builtInVariableTypeUnspecified", "pageUrl", @@ -4253,21 +4298,15 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.clients.create", - "tagmanager.accounts.containers.workspaces.clients.update" - ] - }, - "description": "Client display name. @mutable tagmanager.accounts.containers.workspaces.clients.create @mutable tagmanager.accounts.containers.workspaces.clients.update", + "description": "Client display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this tag in the container. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "User notes on how to apply this tag in the container.", "type": "string" }, "parameter": { - "description": "The client's parameters. @mutable tagmanager.accounts.containers.workspaces.clients.create @mutable tagmanager.accounts.containers.workspaces.clients.update", + "description": "The client's parameters.", "items": { "$ref": "Parameter" }, @@ -4282,7 +4321,7 @@ "type": "string" }, "priority": { - "description": "Priority determines relative firing order. @mutable tagmanager.accounts.containers.workspaces.clients.create @mutable tagmanager.accounts.containers.workspaces.clients.update", + "description": "Priority determines relative firing order.", "format": "int32", "type": "integer" }, @@ -4291,13 +4330,7 @@ "type": "string" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.clients.create", - "tagmanager.accounts.containers.workspaces.clients.update" - ] - }, - "description": "Client type. @mutable tagmanager.accounts.containers.workspaces.clients.create @mutable tagmanager.accounts.containers.workspaces.clients.update", + "description": "Client type.", "type": "string" }, "workspaceId": { @@ -4312,26 +4345,14 @@ "id": "Condition", "properties": { "parameter": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.triggers.create", - "tagmanager.accounts.containers.workspaces.triggers.update" - ] - }, - "description": "A list of named parameters (key/value), depending on the condition's type. Notes: - For binary operators, include parameters named arg0 and arg1 for specifying the left and right operands, respectively. - At this time, the left operand (arg0) must be a reference to a variable. - For case-insensitive Regex matching, include a boolean parameter named ignore_case that is set to true. If not specified or set to any other value, the matching will be case sensitive. - To negate an operator, include a boolean parameter named negate boolean parameter that is set to true. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "A list of named parameters (key/value), depending on the condition's type. Notes: - For binary operators, include parameters named arg0 and arg1 for specifying the left and right operands, respectively. - At this time, the left operand (arg0) must be a reference to a variable. - For case-insensitive Regex matching, include a boolean parameter named ignore_case that is set to true. If not specified or set to any other value, the matching will be case sensitive. - To negate an operator, include a boolean parameter named negate boolean parameter that is set to true. ", "items": { "$ref": "Parameter" }, "type": "array" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.triggers.create", - "tagmanager.accounts.containers.workspaces.triggers.update" - ] - }, - "description": "The type of operator for this condition. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "The type of operator for this condition.", "enum": [ "conditionTypeUnspecified", "equals", @@ -4378,7 +4399,7 @@ "type": "string" }, "domainName": { - "description": "List of domain names associated with the Container. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "List of domain names associated with the Container.", "items": { "type": "string" }, @@ -4393,17 +4414,11 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.create", - "tagmanager.accounts.containers.update" - ] - }, - "description": "Container display name. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Container display name.", "type": "string" }, "notes": { - "description": "Container Notes. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "Container Notes.", "type": "string" }, "path": { @@ -4426,20 +4441,14 @@ "type": "string" }, "taggingServerUrls": { - "description": "List of server-side container URLs for the Container. If multiple URLs are provided, all URL paths must match. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "List of server-side container URLs for the Container. If multiple URLs are provided, all URL paths must match.", "items": { "type": "string" }, "type": "array" }, "usageContext": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.create", - "tagmanager.accounts.containers.update" - ] - }, - "description": "List of Usage Contexts for the Container. Valid values include: web, android, or ios. @mutable tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.update", + "description": "List of Usage Contexts for the Container. Valid values include: web, android, or ios.", "items": { "enum": [ "usageContextUnspecified", @@ -4473,11 +4482,11 @@ "id": "ContainerAccess", "properties": { "containerId": { - "description": "GTM Container ID. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "GTM Container ID.", "type": "string" }, "permission": { - "description": "List of Container permissions. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "List of Container permissions.", "enum": [ "containerPermissionUnspecified", "noAccess", @@ -4607,7 +4616,7 @@ "type": "boolean" }, "description": { - "description": "Container version description. @mutable tagmanager.accounts.containers.versions.update", + "description": "Container version description.", "type": "string" }, "fingerprint": { @@ -4629,7 +4638,7 @@ "type": "array" }, "name": { - "description": "Container version display name. @mutable tagmanager.accounts.containers.versions.update", + "description": "Container version display name.", "type": "string" }, "path": { @@ -4979,11 +4988,11 @@ "type": "string" }, "description": { - "description": "The environment description. Can be set or changed only on USER type environments. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "The environment description. Can be set or changed only on USER type environments.", "type": "string" }, "enableDebug": { - "description": "Whether or not to enable debug by default for the environment. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "Whether or not to enable debug by default for the environment.", "type": "boolean" }, "environmentId": { @@ -4995,13 +5004,7 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.environments.create", - "tagmanager.accounts.containers.environments.update" - ] - }, - "description": "The environment display name. Can be set or changed only on USER type environments. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "The environment display name. Can be set or changed only on USER type environments.", "type": "string" }, "path": { @@ -5029,7 +5032,7 @@ "type": "string" }, "url": { - "description": "Default preview page url for the environment. @mutable tagmanager.accounts.containers.environments.create @mutable tagmanager.accounts.containers.environments.update", + "description": "Default preview page url for the environment.", "type": "string" }, "workspaceId": { @@ -5060,17 +5063,11 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.folders.create", - "tagmanager.accounts.containers.workspaces.folders.update" - ] - }, - "description": "Folder display name. @mutable tagmanager.accounts.containers.workspaces.folders.create @mutable tagmanager.accounts.containers.workspaces.folders.update", + "description": "Folder display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this folder in the container. @mutable tagmanager.accounts.containers.workspaces.folders.create @mutable tagmanager.accounts.containers.workspaces.folders.update", + "description": "User notes on how to apply this folder in the container.", "type": "string" }, "path": { @@ -5215,7 +5212,7 @@ "type": "string" }, "parameter": { - "description": "The Google tag config's parameters. @mutable tagmanager.accounts.containers.workspaces.gtag_config.create @mutable tagmanager.accounts.containers.workspaces.gtag_config.update", + "description": "The Google tag config's parameters.", "items": { "$ref": "Parameter" }, @@ -5230,7 +5227,7 @@ "type": "string" }, "type": { - "description": "Google tag config type. @required tagmanager.accounts.containers.workspaces.gtag_config.create @required tagmanager.accounts.containers.workspaces.gtag_config.update @mutable tagmanager.accounts.containers.workspaces.gtag_config.create @mutable tagmanager.accounts.containers.workspaces.gtag_config.update", + "description": "Google tag config type.", "type": "string" }, "workspaceId": { @@ -5560,39 +5557,29 @@ "id": "Parameter", "properties": { "isWeakReference": { - "description": "Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. @mutable tagmanager.accounts.containers.workspaces.transformations.create @mutable tagmanager.accounts.containers.workspaces.transformations.update", + "description": "Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations.", "type": "boolean" }, "key": { - "description": "The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values.", "type": "string" }, "list": { - "description": "This list parameter's parameters (keys will be ignored). @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "This list parameter's parameters (keys will be ignored).", "items": { "$ref": "Parameter" }, "type": "array" }, "map": { - "description": "This map parameter's parameters (must have keys; keys must be unique). @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "This map parameter's parameters (must have keys; keys must be unique).", "items": { "$ref": "Parameter" }, "type": "array" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.tags.create", - "tagmanager.accounts.containers.workspaces.tags.update", - "tagmanager.accounts.containers.workspaces.triggers.create", - "tagmanager.accounts.containers.workspaces.triggers.update", - "tagmanager.accounts.containers.workspaces.variables.create", - "tagmanager.accounts.containers.workspaces.variables.update" - ] - }, - "description": "The parameter type. Valid values are: - boolean: The value represents a boolean, represented as 'true' or 'false' - integer: The value represents a 64-bit signed integer value, in base 10 - list: A list of parameters should be specified - map: A map of parameters should be specified - template: The value represents any text; this can include variable references (even variable references that might return non-string types) - trigger_reference: The value represents a trigger, represented as the trigger id - tag_reference: The value represents a tag, represented as the tag name @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "The parameter type. Valid values are: - boolean: The value represents a boolean, represented as 'true' or 'false' - integer: The value represents a 64-bit signed integer value, in base 10 - list: A list of parameters should be specified - map: A map of parameters should be specified - template: The value represents any text; this can include variable references (even variable references that might return non-string types) - trigger_reference: The value represents a trigger, represented as the trigger id - tag_reference: The value represents a tag, represented as the tag name ", "enum": [ "typeUnspecified", "template", @@ -5605,7 +5592,7 @@ ], "enumDescriptions": [ "", - "May include variable references (such as \"{{myVariable}}\").", + "May include variable references.", "", "", "", @@ -5616,7 +5603,7 @@ "type": "string" }, "value": { - "description": "A parameter's value (may contain variable references such as \"{{myVariable}}\") as appropriate to the specified type. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "A parameter's value (may contain variable references). as appropriate to the specified type.", "type": "string" } }, @@ -5813,14 +5800,14 @@ }, "blockingRuleId": { "deprecated": true, - "description": "Blocking rule IDs. If any of the listed rules evaluate to true, the tag will not fire. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "Blocking rule IDs. If any of the listed rules evaluate to true, the tag will not fire.", "items": { "type": "string" }, "type": "array" }, "blockingTriggerId": { - "description": "Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag will not fire. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag will not fire.", "items": { "type": "string" }, @@ -5828,7 +5815,7 @@ }, "consentSettings": { "$ref": "TagConsentSetting", - "description": "Consent settings of a tag. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update" + "description": "Consent settings of a tag." }, "containerId": { "description": "GTM Container ID.", @@ -5840,47 +5827,41 @@ }, "firingRuleId": { "deprecated": true, - "description": "Firing rule IDs. A tag will fire when any of the listed rules are true and all of its blockingRuleIds (if any specified) are false. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "Firing rule IDs. A tag will fire when any of the listed rules are true and all of its blockingRuleIds (if any specified) are false.", "items": { "type": "string" }, "type": "array" }, "firingTriggerId": { - "description": "Firing trigger IDs. A tag will fire when any of the listed triggers are true and all of its blockingTriggerIds (if any specified) are false. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "Firing trigger IDs. A tag will fire when any of the listed triggers are true and all of its blockingTriggerIds (if any specified) are false.", "items": { "type": "string" }, "type": "array" }, "liveOnly": { - "description": "If set to true, this tag will only fire in the live environment (e.g. not in preview or debug mode). @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "If set to true, this tag will only fire in the live environment (e.g. not in preview or debug mode).", "type": "boolean" }, "monitoringMetadata": { "$ref": "Parameter", - "description": "A map of key-value pairs of tag metadata to be included in the event data for tag monitoring. Notes: - This parameter must be type MAP. - Each parameter in the map are type TEMPLATE, however cannot contain variable references. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update" + "description": "A map of key-value pairs of tag metadata to be included in the event data for tag monitoring. Notes: - This parameter must be type MAP. - Each parameter in the map are type TEMPLATE, however cannot contain variable references. " }, "monitoringMetadataTagNameKey": { - "description": "If non-empty, then the tag display name will be included in the monitoring metadata map using the key specified. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "If non-empty, then the tag display name will be included in the monitoring metadata map using the key specified.", "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.tags.create", - "tagmanager.accounts.containers.workspaces.tags.update" - ] - }, - "description": "Tag display name. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "Tag display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this tag in the container. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "User notes on how to apply this tag in the container.", "type": "string" }, "parameter": { - "description": "The tag's parameters. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "The tag's parameters.", "items": { "$ref": "Parameter" }, @@ -5895,20 +5876,20 @@ "type": "string" }, "paused": { - "description": "Indicates whether the tag is paused, which prevents the tag from firing. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "Indicates whether the tag is paused, which prevents the tag from firing.", "type": "boolean" }, "priority": { "$ref": "Parameter", - "description": "User defined numeric priority of the tag. Tags are fired asynchronously in order of priority. Tags with higher numeric value fire first. A tag's priority can be a positive or negative value. The default value is 0. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update" + "description": "User defined numeric priority of the tag. Tags are fired asynchronously in order of priority. Tags with higher numeric value fire first. A tag's priority can be a positive or negative value. The default value is 0." }, "scheduleEndMs": { - "description": "The end timestamp in milliseconds to schedule a tag. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "The end timestamp in milliseconds to schedule a tag.", "format": "int64", "type": "string" }, "scheduleStartMs": { - "description": "The start timestamp in milliseconds to schedule a tag. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "The start timestamp in milliseconds to schedule a tag.", "format": "int64", "type": "string" }, @@ -5951,13 +5932,7 @@ "type": "array" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.tags.create", - "tagmanager.accounts.containers.workspaces.tags.update" - ] - }, - "description": "GTM Tag Type. @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update", + "description": "GTM Tag Type.", "type": "string" }, "workspaceId": { @@ -6023,21 +5998,15 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.transformations.create", - "tagmanager.accounts.containers.workspaces.transformations.update" - ] - }, - "description": "Transformation display name. @mutable tagmanager.accounts.containers.workspaces.transformations.create @mutable tagmanager.accounts.containers.workspaces.transformations.update", + "description": "Transformation display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this transformation in the container. @mutable tagmanager.accounts.containers.workspaces.transformations.create @mutable tagmanager.accounts.containers.workspaces.transformations.update", + "description": "User notes on how to apply this transformation in the container.", "type": "string" }, "parameter": { - "description": "The transformation's parameters. @mutable tagmanager.accounts.containers.workspaces.transformations.create @mutable tagmanager.accounts.containers.workspaces.transformations.update", + "description": "The transformation's parameters.", "items": { "$ref": "Parameter" }, @@ -6060,13 +6029,7 @@ "type": "string" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.transformations.create", - "tagmanager.accounts.containers.workspaces.transformations.update" - ] - }, - "description": "Transformation type. @mutable tagmanager.accounts.containers.workspaces.transformations.create @mutable tagmanager.accounts.containers.workspaces.transformations.update", + "description": "Transformation type.", "type": "string" }, "workspaceId": { @@ -6085,7 +6048,7 @@ "type": "string" }, "autoEventFilter": { - "description": "Used in the case of auto event tracking. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "Used in the case of auto event tracking.", "items": { "$ref": "Condition" }, @@ -6093,7 +6056,7 @@ }, "checkValidation": { "$ref": "Parameter", - "description": "Whether or not we should only fire tags if the form submit or link click event is not cancelled by some other event handler (e.g. because of validation). Only valid for Form Submission and Link Click triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Whether or not we should only fire tags if the form submit or link click event is not cancelled by some other event handler (e.g. because of validation). Only valid for Form Submission and Link Click triggers." }, "containerId": { "description": "GTM Container ID.", @@ -6101,10 +6064,10 @@ }, "continuousTimeMinMilliseconds": { "$ref": "Parameter", - "description": "A visibility trigger minimum continuous visible time (in milliseconds). Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "A visibility trigger minimum continuous visible time (in milliseconds). Only valid for AMP Visibility trigger." }, "customEventFilter": { - "description": "Used in the case of custom event, which is fired iff all Conditions are true. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "Used in the case of custom event, which is fired iff all Conditions are true.", "items": { "$ref": "Condition" }, @@ -6112,10 +6075,10 @@ }, "eventName": { "$ref": "Parameter", - "description": "Name of the GTM event that is fired. Only valid for Timer triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Name of the GTM event that is fired. Only valid for Timer triggers." }, "filter": { - "description": "The trigger will only fire iff all Conditions are true. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "The trigger will only fire iff all Conditions are true.", "items": { "$ref": "Condition" }, @@ -6127,40 +6090,34 @@ }, "horizontalScrollPercentageList": { "$ref": "Parameter", - "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled horizontally. Only valid for AMP scroll triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled horizontally. Only valid for AMP scroll triggers." }, "interval": { "$ref": "Parameter", - "description": "Time between triggering recurring Timer Events (in milliseconds). Only valid for Timer triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Time between triggering recurring Timer Events (in milliseconds). Only valid for Timer triggers." }, "intervalSeconds": { "$ref": "Parameter", - "description": "Time between Timer Events to fire (in seconds). Only valid for AMP Timer trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Time between Timer Events to fire (in seconds). Only valid for AMP Timer trigger." }, "limit": { "$ref": "Parameter", - "description": "Limit of the number of GTM events this Timer Trigger will fire. If no limit is set, we will continue to fire GTM events until the user leaves the page. Only valid for Timer triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Limit of the number of GTM events this Timer Trigger will fire. If no limit is set, we will continue to fire GTM events until the user leaves the page. Only valid for Timer triggers." }, "maxTimerLengthSeconds": { "$ref": "Parameter", - "description": "Max time to fire Timer Events (in seconds). Only valid for AMP Timer trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Max time to fire Timer Events (in seconds). Only valid for AMP Timer trigger." }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.triggers.create", - "tagmanager.accounts.containers.workspaces.triggers.update" - ] - }, - "description": "Trigger display name. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "Trigger display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this trigger in the container. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "User notes on how to apply this trigger in the container.", "type": "string" }, "parameter": { - "description": "Additional parameters. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "Additional parameters.", "items": { "$ref": "Parameter" }, @@ -6176,7 +6133,7 @@ }, "selector": { "$ref": "Parameter", - "description": "A click trigger CSS selector (i.e. \"a\", \"button\" etc.). Only valid for AMP Click trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "A click trigger CSS selector (i.e. \"a\", \"button\" etc.). Only valid for AMP Click trigger." }, "tagManagerUrl": { "description": "Auto generated link to the tag manager UI", @@ -6184,19 +6141,14 @@ }, "totalTimeMinMilliseconds": { "$ref": "Parameter", - "description": "A visibility trigger minimum total visible time (in milliseconds). Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "A visibility trigger minimum total visible time (in milliseconds). Only valid for AMP Visibility trigger." }, "triggerId": { "description": "The Trigger ID uniquely identifies the GTM Trigger.", "type": "string" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.triggers.create" - ] - }, - "description": "Defines the data layer event that causes this trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update", + "description": "Defines the data layer event that causes this trigger.", "enum": [ "eventTypeUnspecified", "pageview", @@ -6275,31 +6227,31 @@ }, "uniqueTriggerId": { "$ref": "Parameter", - "description": "Globally unique id of the trigger that auto-generates this (a Form Submit, Link Click or Timer listener) if any. Used to make incompatible auto-events work together with trigger filtering based on trigger ids. This value is populated during output generation since the tags implied by triggers don't exist until then. Only valid for Form Submit, Link Click and Timer triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Globally unique id of the trigger that auto-generates this (a Form Submit, Link Click or Timer listener) if any. Used to make incompatible auto-events work together with trigger filtering based on trigger ids. This value is populated during output generation since the tags implied by triggers don't exist until then. Only valid for Form Submit, Link Click and Timer triggers." }, "verticalScrollPercentageList": { "$ref": "Parameter", - "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled vertically. Only valid for AMP scroll triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled vertically. Only valid for AMP scroll triggers." }, "visibilitySelector": { "$ref": "Parameter", - "description": "A visibility trigger CSS selector (i.e. \"#id\"). Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "A visibility trigger CSS selector (i.e. \"#id\"). Only valid for AMP Visibility trigger." }, "visiblePercentageMax": { "$ref": "Parameter", - "description": "A visibility trigger maximum percent visibility. Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "A visibility trigger maximum percent visibility. Only valid for AMP Visibility trigger." }, "visiblePercentageMin": { "$ref": "Parameter", - "description": "A visibility trigger minimum percent visibility. Only valid for AMP Visibility trigger. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "A visibility trigger minimum percent visibility. Only valid for AMP Visibility trigger." }, "waitForTags": { "$ref": "Parameter", - "description": "Whether or not we should delay the form submissions or link opening until all of the tags have fired (by preventing the default action and later simulating the default action). Only valid for Form Submission and Link Click triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "Whether or not we should delay the form submissions or link opening until all of the tags have fired (by preventing the default action and later simulating the default action). Only valid for Form Submission and Link Click triggers." }, "waitForTagsTimeout": { "$ref": "Parameter", - "description": "How long to wait (in milliseconds) for tags to fire when 'waits_for_tags' above evaluates to true. Only valid for Form Submission and Link Click triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.update" + "description": "How long to wait (in milliseconds) for tags to fire when 'waits_for_tags' above evaluates to true. Only valid for Form Submission and Link Click triggers." }, "workspaceId": { "description": "GTM Workspace ID.", @@ -6314,21 +6266,21 @@ "properties": { "accountAccess": { "$ref": "AccountAccess", - "description": "GTM Account access permissions. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update" + "description": "GTM Account access permissions." }, "accountId": { "description": "The Account ID uniquely identifies the GTM Account.", "type": "string" }, "containerAccess": { - "description": "GTM Container access permissions. @mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.permissions.update", + "description": "GTM Container access permissions.", "items": { "$ref": "ContainerAccess" }, "type": "array" }, "emailAddress": { - "description": "User's email address. @mutable tagmanager.accounts.permissions.create", + "description": "User's email address.", "type": "string" }, "path": { @@ -6351,14 +6303,14 @@ "type": "string" }, "disablingTriggerId": { - "description": "For mobile containers only: A list of trigger IDs for disabling conditional variables; the variable is enabled if one of the enabling trigger is true while all the disabling trigger are false. Treated as an unordered set. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "For mobile containers only: A list of trigger IDs for disabling conditional variables; the variable is enabled if one of the enabling trigger is true while all the disabling trigger are false. Treated as an unordered set.", "items": { "type": "string" }, "type": "array" }, "enablingTriggerId": { - "description": "For mobile containers only: A list of trigger IDs for enabling conditional variables; the variable is enabled if one of the enabling triggers is true while all the disabling triggers are false. Treated as an unordered set. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "For mobile containers only: A list of trigger IDs for enabling conditional variables; the variable is enabled if one of the enabling triggers is true while all the disabling triggers are false. Treated as an unordered set.", "items": { "type": "string" }, @@ -6373,21 +6325,15 @@ "description": "Option to convert a variable value to other value." }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.variables.create", - "tagmanager.accounts.containers.workspaces.variables.update" - ] - }, - "description": "Variable display name. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "Variable display name.", "type": "string" }, "notes": { - "description": "User notes on how to apply this variable in the container. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "User notes on how to apply this variable in the container.", "type": "string" }, "parameter": { - "description": "The variable's parameters. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "The variable's parameters.", "items": { "$ref": "Parameter" }, @@ -6402,12 +6348,12 @@ "type": "string" }, "scheduleEndMs": { - "description": "The end timestamp in milliseconds to schedule a variable. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "The end timestamp in milliseconds to schedule a variable.", "format": "int64", "type": "string" }, "scheduleStartMs": { - "description": "The start timestamp in milliseconds to schedule a variable. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "The start timestamp in milliseconds to schedule a variable.", "format": "int64", "type": "string" }, @@ -6416,13 +6362,7 @@ "type": "string" }, "type": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.variables.create", - "tagmanager.accounts.containers.workspaces.variables.update" - ] - }, - "description": "GTM Variable Type. @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.variables.update", + "description": "GTM Variable Type.", "type": "string" }, "variableId": { @@ -6485,7 +6425,7 @@ "type": "string" }, "description": { - "description": "Workspace description. @mutable tagmanager.accounts.containers.workspaces.create @mutable tagmanager.accounts.containers.workspaces.update", + "description": "Workspace description.", "type": "string" }, "fingerprint": { @@ -6493,13 +6433,7 @@ "type": "string" }, "name": { - "annotations": { - "required": [ - "tagmanager.accounts.containers.workspaces.create", - "tagmanager.accounts.containers.workspaces.update" - ] - }, - "description": "Workspace display name. @mutable tagmanager.accounts.containers.workspaces.create @mutable tagmanager.accounts.containers.workspaces.update", + "description": "Workspace display name.", "type": "string" }, "path": { diff --git a/tagmanager/v2/tagmanager-gen.go b/tagmanager/v2/tagmanager-gen.go index 062d9dfa75..fef4a5c23e 100644 --- a/tagmanager/v2/tagmanager-gen.go +++ b/tagmanager/v2/tagmanager-gen.go @@ -408,8 +408,7 @@ type Account struct { // Fingerprint: The fingerprint of the GTM Account as computed at storage time. // This value is recomputed whenever the account is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Account display name. @mutable tagmanager.accounts.create @mutable - // tagmanager.accounts.update + // Name: Account display name. Name string `json:"name,omitempty"` // Path: GTM Account's API relative path. Path string `json:"path,omitempty"` @@ -417,8 +416,7 @@ type Account struct { // others. This flag enables benchmarking by sharing your data in an anonymous // form. Google will remove all identifiable information about your website, // combine the data with hundreds of other anonymous sites and report aggregate - // trends in the benchmarking service. @mutable tagmanager.accounts.create - // @mutable tagmanager.accounts.update + // trends in the benchmarking service. ShareData bool `json:"shareData,omitempty"` // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` @@ -446,8 +444,7 @@ func (s Account) MarshalJSON() ([]byte, error) { // AccountAccess: Defines the Google Tag Manager Account access permissions. type AccountAccess struct { // Permission: Whether the user has no access, user access, or admin access to - // an account. @mutable tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // an account. // // Possible values: // "accountPermissionUnspecified" @@ -513,8 +510,6 @@ type BuiltInVariable struct { // Path: GTM BuiltInVariable's API relative path. Path string `json:"path,omitempty"` // Type: Type of built-in variable. - // @required.tagmanager.accounts.containers.workspaces.built_in_variable.update - // @mutable tagmanager.accounts.containers.workspaces.built_in_variable.update // // Possible values: // "builtInVariableTypeUnspecified" @@ -662,31 +657,21 @@ type Client struct { // Fingerprint: The fingerprint of the GTM Client as computed at storage time. // This value is recomputed whenever the client is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Client display name. @mutable - // tagmanager.accounts.containers.workspaces.clients.create @mutable - // tagmanager.accounts.containers.workspaces.clients.update + // Name: Client display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this tag in the container. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // Notes: User notes on how to apply this tag in the container. Notes string `json:"notes,omitempty"` - // Parameter: The client's parameters. @mutable - // tagmanager.accounts.containers.workspaces.clients.create @mutable - // tagmanager.accounts.containers.workspaces.clients.update + // Parameter: The client's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // Path: GTM client's API relative path. Path string `json:"path,omitempty"` - // Priority: Priority determines relative firing order. @mutable - // tagmanager.accounts.containers.workspaces.clients.create @mutable - // tagmanager.accounts.containers.workspaces.clients.update + // Priority: Priority determines relative firing order. Priority int64 `json:"priority,omitempty"` // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` - // Type: Client type. @mutable - // tagmanager.accounts.containers.workspaces.clients.create @mutable - // tagmanager.accounts.containers.workspaces.clients.update + // Type: Client type. Type string `json:"type,omitempty"` // WorkspaceId: GTM Workspace ID. WorkspaceId string `json:"workspaceId,omitempty"` @@ -721,12 +706,8 @@ type Condition struct { // ignore_case that is set to true. If not specified or set to any other value, // the matching will be case sensitive. - To negate an operator, include a // boolean parameter named negate boolean parameter that is set to true. - // @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update Parameter []*Parameter `json:"parameter,omitempty"` - // Type: The type of operator for this condition. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Type: The type of operator for this condition. // // Possible values: // "conditionTypeUnspecified" @@ -768,20 +749,16 @@ type Container struct { AccountId string `json:"accountId,omitempty"` // ContainerId: The Container ID uniquely identifies the GTM Container. ContainerId string `json:"containerId,omitempty"` - // DomainName: List of domain names associated with the Container. @mutable - // tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update + // DomainName: List of domain names associated with the Container. DomainName []string `json:"domainName,omitempty"` // Features: Read-only Container feature set. Features *ContainerFeatures `json:"features,omitempty"` // Fingerprint: The fingerprint of the GTM Container as computed at storage // time. This value is recomputed whenever the account is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Container display name. @mutable tagmanager.accounts.containers.create - // @mutable tagmanager.accounts.containers.update + // Name: Container display name. Name string `json:"name,omitempty"` - // Notes: Container Notes. @mutable tagmanager.accounts.containers.create - // @mutable tagmanager.accounts.containers.update + // Notes: Container Notes. Notes string `json:"notes,omitempty"` // Path: GTM Container's API relative path. Path string `json:"path,omitempty"` @@ -792,14 +769,10 @@ type Container struct { // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` // TaggingServerUrls: List of server-side container URLs for the Container. If - // multiple URLs are provided, all URL paths must match. @mutable - // tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update + // multiple URLs are provided, all URL paths must match. TaggingServerUrls []string `json:"taggingServerUrls,omitempty"` // UsageContext: List of Usage Contexts for the Container. Valid values - // include: web, android, or ios. @mutable - // tagmanager.accounts.containers.create @mutable - // tagmanager.accounts.containers.update + // include: web, android, or ios. // // Possible values: // "usageContextUnspecified" @@ -835,13 +808,9 @@ func (s Container) MarshalJSON() ([]byte, error) { // ContainerAccess: Defines the Google Tag Manager Container access // permissions. type ContainerAccess struct { - // ContainerId: GTM Container ID. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` - // Permission: List of Container permissions. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // Permission: List of Container permissions. // // Possible values: // "containerPermissionUnspecified" @@ -938,8 +907,7 @@ type ContainerVersion struct { CustomTemplate []*CustomTemplate `json:"customTemplate,omitempty"` // Deleted: A value of true indicates this container version has been deleted. Deleted bool `json:"deleted,omitempty"` - // Description: Container version description. @mutable - // tagmanager.accounts.containers.versions.update + // Description: Container version description. Description string `json:"description,omitempty"` // Fingerprint: The fingerprint of the GTM Container Version as computed at // storage time. This value is recomputed whenever the container version is @@ -950,8 +918,7 @@ type ContainerVersion struct { // GtagConfig: The Google tag configs in the container that this version was // taken from. GtagConfig []*GtagConfig `json:"gtagConfig,omitempty"` - // Name: Container version display name. @mutable - // tagmanager.accounts.containers.versions.update + // Name: Container version display name. Name string `json:"name,omitempty"` // Path: GTM Container Version's API relative path. Path string `json:"path,omitempty"` @@ -1281,13 +1248,9 @@ type Environment struct { // ContainerVersionId: Represents a link to a container version. ContainerVersionId string `json:"containerVersionId,omitempty"` // Description: The environment description. Can be set or changed only on USER - // type environments. @mutable - // tagmanager.accounts.containers.environments.create @mutable - // tagmanager.accounts.containers.environments.update + // type environments. Description string `json:"description,omitempty"` // EnableDebug: Whether or not to enable debug by default for the environment. - // @mutable tagmanager.accounts.containers.environments.create @mutable - // tagmanager.accounts.containers.environments.update EnableDebug bool `json:"enableDebug,omitempty"` // EnvironmentId: GTM Environment ID uniquely identifies the GTM Environment. EnvironmentId string `json:"environmentId,omitempty"` @@ -1295,8 +1258,7 @@ type Environment struct { // time. This value is recomputed whenever the environment is modified. Fingerprint string `json:"fingerprint,omitempty"` // Name: The environment display name. Can be set or changed only on USER type - // environments. @mutable tagmanager.accounts.containers.environments.create - // @mutable tagmanager.accounts.containers.environments.update + // environments. Name string `json:"name,omitempty"` // Path: GTM Environment's API relative path. Path string `json:"path,omitempty"` @@ -1311,9 +1273,7 @@ type Environment struct { // "workspace" - Automatically managed environment that points to a workspace // preview or version created by a workspace. Type string `json:"type,omitempty"` - // Url: Default preview page url for the environment. @mutable - // tagmanager.accounts.containers.environments.create @mutable - // tagmanager.accounts.containers.environments.update + // Url: Default preview page url for the environment. Url string `json:"url,omitempty"` // WorkspaceId: Represents a link to a quick preview of a workspace. WorkspaceId string `json:"workspaceId,omitempty"` @@ -1349,13 +1309,9 @@ type Folder struct { Fingerprint string `json:"fingerprint,omitempty"` // FolderId: The Folder ID uniquely identifies the GTM Folder. FolderId string `json:"folderId,omitempty"` - // Name: Folder display name. @mutable - // tagmanager.accounts.containers.workspaces.folders.create @mutable - // tagmanager.accounts.containers.workspaces.folders.update + // Name: Folder display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this folder in the container. @mutable - // tagmanager.accounts.containers.workspaces.folders.create @mutable - // tagmanager.accounts.containers.workspaces.folders.update + // Notes: User notes on how to apply this folder in the container. Notes string `json:"notes,omitempty"` // Path: GTM Folder's API relative path. Path string `json:"path,omitempty"` @@ -1522,19 +1478,13 @@ type GtagConfig struct { Fingerprint string `json:"fingerprint,omitempty"` // GtagConfigId: The ID uniquely identifies the Google tag config. GtagConfigId string `json:"gtagConfigId,omitempty"` - // Parameter: The Google tag config's parameters. @mutable - // tagmanager.accounts.containers.workspaces.gtag_config.create @mutable - // tagmanager.accounts.containers.workspaces.gtag_config.update + // Parameter: The Google tag config's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // Path: Google tag config's API relative path. Path string `json:"path,omitempty"` // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` - // Type: Google tag config type. @required - // tagmanager.accounts.containers.workspaces.gtag_config.create @required - // tagmanager.accounts.containers.workspaces.gtag_config.update @mutable - // tagmanager.accounts.containers.workspaces.gtag_config.create @mutable - // tagmanager.accounts.containers.workspaces.gtag_config.update + // Type: Google tag config type. Type string `json:"type,omitempty"` // WorkspaceId: Google tag workspace ID. Only used by GTM containers. Set to 0 // otherwise. @@ -2045,34 +1995,14 @@ func (s MergeConflict) MarshalJSON() ([]byte, error) { // Parameter: Represents a Google Tag Manager Parameter. type Parameter struct { // IsWeakReference: Whether or not a reference type parameter is strongly or - // weakly referenced. Only used by Transformations. @mutable - // tagmanager.accounts.containers.workspaces.transformations.create @mutable - // tagmanager.accounts.containers.workspaces.transformations.update + // weakly referenced. Only used by Transformations. IsWeakReference bool `json:"isWeakReference,omitempty"` // Key: The named key that uniquely identifies a parameter. Required for // top-level parameters, as well as map values. Ignored for list values. - // @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update Key string `json:"key,omitempty"` - // List: This list parameter's parameters (keys will be ignored). @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // List: This list parameter's parameters (keys will be ignored). List []*Parameter `json:"list,omitempty"` // Map: This map parameter's parameters (must have keys; keys must be unique). - // @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update Map []*Parameter `json:"map,omitempty"` // Type: The parameter type. Valid values are: - boolean: The value represents // a boolean, represented as 'true' or 'false' - integer: The value represents @@ -2082,16 +2012,11 @@ type Parameter struct { // references (even variable references that might return non-string types) - // trigger_reference: The value represents a trigger, represented as the // trigger id - tag_reference: The value represents a tag, represented as the - // tag name @mutable tagmanager.accounts.containers.workspaces.variables.create - // @mutable tagmanager.accounts.containers.workspaces.variables.update @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // tag name // // Possible values: // "typeUnspecified" - // "template" - May include variable references (such as "{{myVariable}}"). + // "template" - May include variable references. // "integer" // "boolean" // "list" @@ -2099,14 +2024,8 @@ type Parameter struct { // "triggerReference" // "tagReference" Type string `json:"type,omitempty"` - // Value: A parameter's value (may contain variable references such as - // "{{myVariable}}") as appropriate to the specified type. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // Value: A parameter's value (may contain variable references). as appropriate + // to the specified type. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "IsWeakReference") to // unconditionally include in API requests. By default, fields with empty or @@ -2514,18 +2433,12 @@ type Tag struct { // AccountId: GTM Account ID. AccountId string `json:"accountId,omitempty"` // BlockingRuleId: Blocking rule IDs. If any of the listed rules evaluate to - // true, the tag will not fire. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // true, the tag will not fire. BlockingRuleId []string `json:"blockingRuleId,omitempty"` // BlockingTriggerId: Blocking trigger IDs. If any of the listed triggers - // evaluate to true, the tag will not fire. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // evaluate to true, the tag will not fire. BlockingTriggerId []string `json:"blockingTriggerId,omitempty"` - // ConsentSettings: Consent settings of a tag. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // ConsentSettings: Consent settings of a tag. ConsentSettings *TagConsentSetting `json:"consentSettings,omitempty"` // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` @@ -2534,64 +2447,43 @@ type Tag struct { Fingerprint string `json:"fingerprint,omitempty"` // FiringRuleId: Firing rule IDs. A tag will fire when any of the listed rules // are true and all of its blockingRuleIds (if any specified) are false. - // @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update FiringRuleId []string `json:"firingRuleId,omitempty"` // FiringTriggerId: Firing trigger IDs. A tag will fire when any of the listed // triggers are true and all of its blockingTriggerIds (if any specified) are - // false. @mutable tagmanager.accounts.containers.workspaces.tags.create - // @mutable tagmanager.accounts.containers.workspaces.tags.update + // false. FiringTriggerId []string `json:"firingTriggerId,omitempty"` // LiveOnly: If set to true, this tag will only fire in the live environment - // (e.g. not in preview or debug mode). @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // (e.g. not in preview or debug mode). LiveOnly bool `json:"liveOnly,omitempty"` // MonitoringMetadata: A map of key-value pairs of tag metadata to be included // in the event data for tag monitoring. Notes: - This parameter must be type // MAP. - Each parameter in the map are type TEMPLATE, however cannot contain - // variable references. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // variable references. MonitoringMetadata *Parameter `json:"monitoringMetadata,omitempty"` // MonitoringMetadataTagNameKey: If non-empty, then the tag display name will - // be included in the monitoring metadata map using the key specified. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // be included in the monitoring metadata map using the key specified. MonitoringMetadataTagNameKey string `json:"monitoringMetadataTagNameKey,omitempty"` - // Name: Tag display name. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // Name: Tag display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this tag in the container. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // Notes: User notes on how to apply this tag in the container. Notes string `json:"notes,omitempty"` - // Parameter: The tag's parameters. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // Parameter: The tag's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // Path: GTM Tag's API relative path. Path string `json:"path,omitempty"` // Paused: Indicates whether the tag is paused, which prevents the tag from - // firing. @mutable tagmanager.accounts.containers.workspaces.tags.create - // @mutable tagmanager.accounts.containers.workspaces.tags.update + // firing. Paused bool `json:"paused,omitempty"` // Priority: User defined numeric priority of the tag. Tags are fired // asynchronously in order of priority. Tags with higher numeric value fire // first. A tag's priority can be a positive or negative value. The default - // value is 0. @mutable tagmanager.accounts.containers.workspaces.tags.create - // @mutable tagmanager.accounts.containers.workspaces.tags.update + // value is 0. Priority *Parameter `json:"priority,omitempty"` - // ScheduleEndMs: The end timestamp in milliseconds to schedule a tag. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // ScheduleEndMs: The end timestamp in milliseconds to schedule a tag. ScheduleEndMs int64 `json:"scheduleEndMs,omitempty,string"` // ScheduleStartMs: The start timestamp in milliseconds to schedule a tag. - // @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update ScheduleStartMs int64 `json:"scheduleStartMs,omitempty,string"` // SetupTag: The list of setup tags. Currently we only allow one. SetupTag []*SetupTag `json:"setupTag,omitempty"` @@ -2611,9 +2503,7 @@ type Tag struct { TagManagerUrl string `json:"tagManagerUrl,omitempty"` // TeardownTag: The list of teardown tags. Currently we only allow one. TeardownTag []*TeardownTag `json:"teardownTag,omitempty"` - // Type: GTM Tag Type. @mutable - // tagmanager.accounts.containers.workspaces.tags.create @mutable - // tagmanager.accounts.containers.workspaces.tags.update + // Type: GTM Tag Type. Type string `json:"type,omitempty"` // WorkspaceId: GTM Workspace ID. WorkspaceId string `json:"workspaceId,omitempty"` @@ -2707,17 +2597,11 @@ type Transformation struct { // storage time. This value is recomputed whenever the transformation is // modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Transformation display name. @mutable - // tagmanager.accounts.containers.workspaces.transformations.create @mutable - // tagmanager.accounts.containers.workspaces.transformations.update + // Name: Transformation display name. Name string `json:"name,omitempty"` // Notes: User notes on how to apply this transformation in the container. - // @mutable tagmanager.accounts.containers.workspaces.transformations.create - // @mutable tagmanager.accounts.containers.workspaces.transformations.update Notes string `json:"notes,omitempty"` - // Parameter: The transformation's parameters. @mutable - // tagmanager.accounts.containers.workspaces.transformations.create @mutable - // tagmanager.accounts.containers.workspaces.transformations.update + // Parameter: The transformation's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` @@ -2728,9 +2612,7 @@ type Transformation struct { // TransformationId: The Transformation ID uniquely identifies the GTM // transformation. TransformationId string `json:"transformationId,omitempty"` - // Type: Transformation type. @mutable - // tagmanager.accounts.containers.workspaces.transformations.create @mutable - // tagmanager.accounts.containers.workspaces.transformations.update + // Type: Transformation type. Type string `json:"type,omitempty"` // WorkspaceId: GTM Workspace ID. WorkspaceId string `json:"workspaceId,omitempty"` @@ -2759,99 +2641,67 @@ func (s Transformation) MarshalJSON() ([]byte, error) { type Trigger struct { // AccountId: GTM Account ID. AccountId string `json:"accountId,omitempty"` - // AutoEventFilter: Used in the case of auto event tracking. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // AutoEventFilter: Used in the case of auto event tracking. AutoEventFilter []*Condition `json:"autoEventFilter,omitempty"` // CheckValidation: Whether or not we should only fire tags if the form submit // or link click event is not cancelled by some other event handler (e.g. // because of validation). Only valid for Form Submission and Link Click - // triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create - // @mutable tagmanager.accounts.containers.workspaces.triggers.update + // triggers. CheckValidation *Parameter `json:"checkValidation,omitempty"` // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` // ContinuousTimeMinMilliseconds: A visibility trigger minimum continuous // visible time (in milliseconds). Only valid for AMP Visibility trigger. - // @mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update ContinuousTimeMinMilliseconds *Parameter `json:"continuousTimeMinMilliseconds,omitempty"` // CustomEventFilter: Used in the case of custom event, which is fired iff all - // Conditions are true. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Conditions are true. CustomEventFilter []*Condition `json:"customEventFilter,omitempty"` // EventName: Name of the GTM event that is fired. Only valid for Timer - // triggers. @mutable tagmanager.accounts.containers.workspaces.triggers.create - // @mutable tagmanager.accounts.containers.workspaces.triggers.update + // triggers. EventName *Parameter `json:"eventName,omitempty"` - // Filter: The trigger will only fire iff all Conditions are true. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Filter: The trigger will only fire iff all Conditions are true. Filter []*Condition `json:"filter,omitempty"` // Fingerprint: The fingerprint of the GTM Trigger as computed at storage time. // This value is recomputed whenever the trigger is modified. Fingerprint string `json:"fingerprint,omitempty"` // HorizontalScrollPercentageList: List of integer percentage values for scroll // triggers. The trigger will fire when each percentage is reached when the - // view is scrolled horizontally. Only valid for AMP scroll triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // view is scrolled horizontally. Only valid for AMP scroll triggers. HorizontalScrollPercentageList *Parameter `json:"horizontalScrollPercentageList,omitempty"` // Interval: Time between triggering recurring Timer Events (in milliseconds). - // Only valid for Timer triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Only valid for Timer triggers. Interval *Parameter `json:"interval,omitempty"` // IntervalSeconds: Time between Timer Events to fire (in seconds). Only valid - // for AMP Timer trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // for AMP Timer trigger. IntervalSeconds *Parameter `json:"intervalSeconds,omitempty"` // Limit: Limit of the number of GTM events this Timer Trigger will fire. If no // limit is set, we will continue to fire GTM events until the user leaves the - // page. Only valid for Timer triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // page. Only valid for Timer triggers. Limit *Parameter `json:"limit,omitempty"` // MaxTimerLengthSeconds: Max time to fire Timer Events (in seconds). Only - // valid for AMP Timer trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // valid for AMP Timer trigger. MaxTimerLengthSeconds *Parameter `json:"maxTimerLengthSeconds,omitempty"` - // Name: Trigger display name. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Name: Trigger display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this trigger in the container. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Notes: User notes on how to apply this trigger in the container. Notes string `json:"notes,omitempty"` - // Parameter: Additional parameters. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Parameter: Additional parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // Path: GTM Trigger's API relative path. Path string `json:"path,omitempty"` // Selector: A click trigger CSS selector (i.e. "a", "button" etc.). Only valid - // for AMP Click trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // for AMP Click trigger. Selector *Parameter `json:"selector,omitempty"` // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` // TotalTimeMinMilliseconds: A visibility trigger minimum total visible time - // (in milliseconds). Only valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // (in milliseconds). Only valid for AMP Visibility trigger. TotalTimeMinMilliseconds *Parameter `json:"totalTimeMinMilliseconds,omitempty"` // TriggerId: The Trigger ID uniquely identifies the GTM Trigger. TriggerId string `json:"triggerId,omitempty"` - // Type: Defines the data layer event that causes this trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Type: Defines the data layer event that causes this trigger. // // Possible values: // "eventTypeUnspecified" @@ -2895,43 +2745,29 @@ type Trigger struct { // incompatible auto-events work together with trigger filtering based on // trigger ids. This value is populated during output generation since the tags // implied by triggers don't exist until then. Only valid for Form Submit, Link - // Click and Timer triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Click and Timer triggers. UniqueTriggerId *Parameter `json:"uniqueTriggerId,omitempty"` // VerticalScrollPercentageList: List of integer percentage values for scroll // triggers. The trigger will fire when each percentage is reached when the - // view is scrolled vertically. Only valid for AMP scroll triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // view is scrolled vertically. Only valid for AMP scroll triggers. VerticalScrollPercentageList *Parameter `json:"verticalScrollPercentageList,omitempty"` // VisibilitySelector: A visibility trigger CSS selector (i.e. "#id"). Only - // valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // valid for AMP Visibility trigger. VisibilitySelector *Parameter `json:"visibilitySelector,omitempty"` // VisiblePercentageMax: A visibility trigger maximum percent visibility. Only - // valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // valid for AMP Visibility trigger. VisiblePercentageMax *Parameter `json:"visiblePercentageMax,omitempty"` // VisiblePercentageMin: A visibility trigger minimum percent visibility. Only - // valid for AMP Visibility trigger. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // valid for AMP Visibility trigger. VisiblePercentageMin *Parameter `json:"visiblePercentageMin,omitempty"` // WaitForTags: Whether or not we should delay the form submissions or link // opening until all of the tags have fired (by preventing the default action // and later simulating the default action). Only valid for Form Submission and - // Link Click triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Link Click triggers. WaitForTags *Parameter `json:"waitForTags,omitempty"` // WaitForTagsTimeout: How long to wait (in milliseconds) for tags to fire when // 'waits_for_tags' above evaluates to true. Only valid for Form Submission and - // Link Click triggers. @mutable - // tagmanager.accounts.containers.workspaces.triggers.create @mutable - // tagmanager.accounts.containers.workspaces.triggers.update + // Link Click triggers. WaitForTagsTimeout *Parameter `json:"waitForTagsTimeout,omitempty"` // WorkspaceId: GTM Workspace ID. WorkspaceId string `json:"workspaceId,omitempty"` @@ -2959,18 +2795,13 @@ func (s Trigger) MarshalJSON() ([]byte, error) { // UserPermission: Represents a user's permissions to an account and its // container. type UserPermission struct { - // AccountAccess: GTM Account access permissions. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // AccountAccess: GTM Account access permissions. AccountAccess *AccountAccess `json:"accountAccess,omitempty"` // AccountId: The Account ID uniquely identifies the GTM Account. AccountId string `json:"accountId,omitempty"` - // ContainerAccess: GTM Container access permissions. @mutable - // tagmanager.accounts.permissions.create @mutable - // tagmanager.accounts.permissions.update + // ContainerAccess: GTM Container access permissions. ContainerAccess []*ContainerAccess `json:"containerAccess,omitempty"` - // EmailAddress: User's email address. @mutable - // tagmanager.accounts.permissions.create + // EmailAddress: User's email address. EmailAddress string `json:"emailAddress,omitempty"` // Path: GTM UserPermission's API relative path. Path string `json:"path,omitempty"` @@ -3004,51 +2835,35 @@ type Variable struct { // DisablingTriggerId: For mobile containers only: A list of trigger IDs for // disabling conditional variables; the variable is enabled if one of the // enabling trigger is true while all the disabling trigger are false. Treated - // as an unordered set. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update + // as an unordered set. DisablingTriggerId []string `json:"disablingTriggerId,omitempty"` // EnablingTriggerId: For mobile containers only: A list of trigger IDs for // enabling conditional variables; the variable is enabled if one of the // enabling triggers is true while all the disabling triggers are false. - // Treated as an unordered set. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update + // Treated as an unordered set. EnablingTriggerId []string `json:"enablingTriggerId,omitempty"` // Fingerprint: The fingerprint of the GTM Variable as computed at storage // time. This value is recomputed whenever the variable is modified. Fingerprint string `json:"fingerprint,omitempty"` // FormatValue: Option to convert a variable value to other value. FormatValue *VariableFormatValue `json:"formatValue,omitempty"` - // Name: Variable display name. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update + // Name: Variable display name. Name string `json:"name,omitempty"` - // Notes: User notes on how to apply this variable in the container. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update + // Notes: User notes on how to apply this variable in the container. Notes string `json:"notes,omitempty"` - // Parameter: The variable's parameters. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update + // Parameter: The variable's parameters. Parameter []*Parameter `json:"parameter,omitempty"` // ParentFolderId: Parent folder id. ParentFolderId string `json:"parentFolderId,omitempty"` // Path: GTM Variable's API relative path. Path string `json:"path,omitempty"` // ScheduleEndMs: The end timestamp in milliseconds to schedule a variable. - // @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update ScheduleEndMs int64 `json:"scheduleEndMs,omitempty,string"` // ScheduleStartMs: The start timestamp in milliseconds to schedule a variable. - // @mutable tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update ScheduleStartMs int64 `json:"scheduleStartMs,omitempty,string"` // TagManagerUrl: Auto generated link to the tag manager UI TagManagerUrl string `json:"tagManagerUrl,omitempty"` - // Type: GTM Variable Type. @mutable - // tagmanager.accounts.containers.workspaces.variables.create @mutable - // tagmanager.accounts.containers.workspaces.variables.update + // Type: GTM Variable Type. Type string `json:"type,omitempty"` // VariableId: The Variable ID uniquely identifies the GTM Variable. VariableId string `json:"variableId,omitempty"` @@ -3117,16 +2932,12 @@ type Workspace struct { AccountId string `json:"accountId,omitempty"` // ContainerId: GTM Container ID. ContainerId string `json:"containerId,omitempty"` - // Description: Workspace description. @mutable - // tagmanager.accounts.containers.workspaces.create @mutable - // tagmanager.accounts.containers.workspaces.update + // Description: Workspace description. Description string `json:"description,omitempty"` // Fingerprint: The fingerprint of the GTM Workspace as computed at storage // time. This value is recomputed whenever the workspace is modified. Fingerprint string `json:"fingerprint,omitempty"` - // Name: Workspace display name. @mutable - // tagmanager.accounts.containers.workspaces.create @mutable - // tagmanager.accounts.containers.workspaces.update + // Name: Workspace display name. Name string `json:"name,omitempty"` // Path: GTM Workspace's API relative path. Path string `json:"path,omitempty"` @@ -3288,7 +3099,7 @@ type AccountsGetCall struct { // Get: Gets a GTM Account. // -// - path: GTM Account's API relative path. Example: accounts/{account_id}. +// - path: GTM Account's API relative path. func (r *AccountsService) Get(path string) *AccountsGetCall { c := &AccountsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -3535,7 +3346,7 @@ type AccountsUpdateCall struct { // Update: Updates a GTM Account. // -// - path: GTM Account's API relative path. Example: accounts/{account_id}. +// - path: GTM Account's API relative path. func (r *AccountsService) Update(path string, account *Account) *AccountsUpdateCall { c := &AccountsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -3644,8 +3455,7 @@ type AccountsContainersCombineCall struct { // Combine: Combines Containers. // -// - path: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - path: GTM Container's API relative path. func (r *AccountsContainersService) Combine(path string) *AccountsContainersCombineCall { c := &AccountsContainersCombineCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -3772,7 +3582,7 @@ type AccountsContainersCreateCall struct { // Create: Creates a Container. // -// - parent: GTM Account's API relative path. Example: accounts/{account_id}. +// - parent: GTM Account's API relative path. func (r *AccountsContainersService) Create(parent string, container *Container) *AccountsContainersCreateCall { c := &AccountsContainersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3874,8 +3684,7 @@ type AccountsContainersDeleteCall struct { // Delete: Deletes a Container. // -// - path: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - path: GTM Container's API relative path. func (r *AccountsContainersService) Delete(path string) *AccountsContainersDeleteCall { c := &AccountsContainersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -3949,8 +3758,7 @@ type AccountsContainersGetCall struct { // Get: Gets a Container. // -// - path: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - path: GTM Container's API relative path. func (r *AccountsContainersService) Get(path string) *AccountsContainersGetCall { c := &AccountsContainersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -4059,7 +3867,7 @@ type AccountsContainersListCall struct { // List: Lists all Containers that belongs to a GTM Account. // -// - parent: GTM Account's API relative path. Example: accounts/{account_id}. +// - parent: GTM Account's API relative path. func (r *AccountsContainersService) List(parent string) *AccountsContainersListCall { c := &AccountsContainersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4201,17 +4009,15 @@ func (r *AccountsContainersService) Lookup() *AccountsContainersLookupCall { } // DestinationId sets the optional parameter "destinationId": Destination ID -// linked to a GTM Container, e.g. AW-123456789. Example: -// accounts/containers:lookup?destination_id={destination_id}. Only one of -// destination_id or tag_id should be set. +// linked to a GTM Container, e.g. AW-123456789. Only one of destination_id or +// tag_id should be set. func (c *AccountsContainersLookupCall) DestinationId(destinationId string) *AccountsContainersLookupCall { c.urlParams_.Set("destinationId", destinationId) return c } // TagId sets the optional parameter "tagId": Tag ID for a GTM Container, e.g. -// GTM-123456789. Example: accounts/containers:lookup?tag_id={tag_id}. Only one -// of destination_id or tag_id should be set. +// GTM-123456789. Only one of destination_id or tag_id should be set. func (c *AccountsContainersLookupCall) TagId(tagId string) *AccountsContainersLookupCall { c.urlParams_.Set("tagId", tagId) return c @@ -4315,8 +4121,7 @@ type AccountsContainersMoveTagIdCall struct { // MoveTagId: Move Tag ID out of a Container. // -// - path: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - path: GTM Container's API relative path. func (r *AccountsContainersService) MoveTagId(path string) *AccountsContainersMoveTagIdCall { c := &AccountsContainersMoveTagIdCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -4460,8 +4265,7 @@ type AccountsContainersSnippetCall struct { // Snippet: Gets the tagging snippet for a Container. // -// - path: Container snippet's API relative path. Example: -// accounts/{account_id}/containers/{container_id}:snippet. +// - path: Container snippet's API relative path. func (r *AccountsContainersService) Snippet(path string) *AccountsContainersSnippetCall { c := &AccountsContainersSnippetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -4571,8 +4375,7 @@ type AccountsContainersUpdateCall struct { // Update: Updates a Container. // -// - path: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - path: GTM Container's API relative path. func (r *AccountsContainersService) Update(path string, container *Container) *AccountsContainersUpdateCall { c := &AccountsContainersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -4682,9 +4485,7 @@ type AccountsContainersDestinationsGetCall struct { // Get: Gets a Destination. // -// - path: Google Tag Destination's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/destinations/{destination_l -// ink_id}. +// - path: Google Tag Destination's API relative path. func (r *AccountsContainersDestinationsService) Get(path string) *AccountsContainersDestinationsGetCall { c := &AccountsContainersDestinationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -4793,8 +4594,7 @@ type AccountsContainersDestinationsLinkCall struct { // Link: Adds a Destination to this Container and removes it from the Container // to which it is currently linked. // -// - parent: GTM parent Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM parent Container's API relative path. func (r *AccountsContainersDestinationsService) Link(parent string) *AccountsContainersDestinationsLinkCall { c := &AccountsContainersDestinationsLinkCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4908,8 +4708,7 @@ type AccountsContainersDestinationsListCall struct { // List: Lists all Destinations linked to a GTM Container. // -// - parent: GTM parent Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM parent Container's API relative path. func (r *AccountsContainersDestinationsService) List(parent string) *AccountsContainersDestinationsListCall { c := &AccountsContainersDestinationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5019,8 +4818,7 @@ type AccountsContainersEnvironmentsCreateCall struct { // Create: Creates a GTM Environment. // -// - parent: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM Container's API relative path. func (r *AccountsContainersEnvironmentsService) Create(parent string, environment *Environment) *AccountsContainersEnvironmentsCreateCall { c := &AccountsContainersEnvironmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5122,9 +4920,7 @@ type AccountsContainersEnvironmentsDeleteCall struct { // Delete: Deletes a GTM Environment. // -// - path: GTM Environment's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/environments/{environment_i -// d}. +// - path: GTM Environment's API relative path. func (r *AccountsContainersEnvironmentsService) Delete(path string) *AccountsContainersEnvironmentsDeleteCall { c := &AccountsContainersEnvironmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -5198,9 +4994,7 @@ type AccountsContainersEnvironmentsGetCall struct { // Get: Gets a GTM Environment. // -// - path: GTM Environment's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/environments/{environment_i -// d}. +// - path: GTM Environment's API relative path. func (r *AccountsContainersEnvironmentsService) Get(path string) *AccountsContainersEnvironmentsGetCall { c := &AccountsContainersEnvironmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -5309,8 +5103,7 @@ type AccountsContainersEnvironmentsListCall struct { // List: Lists all GTM Environments of a GTM Container. // -// - parent: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM Container's API relative path. func (r *AccountsContainersEnvironmentsService) List(parent string) *AccountsContainersEnvironmentsListCall { c := &AccountsContainersEnvironmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5448,9 +5241,7 @@ type AccountsContainersEnvironmentsReauthorizeCall struct { // Reauthorize: Re-generates the authorization code for a GTM Environment. // -// - path: GTM Environment's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/environments/{environment_i -// d}. +// - path: GTM Environment's API relative path. func (r *AccountsContainersEnvironmentsService) Reauthorize(path string, environment *Environment) *AccountsContainersEnvironmentsReauthorizeCall { c := &AccountsContainersEnvironmentsReauthorizeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -5553,9 +5344,7 @@ type AccountsContainersEnvironmentsUpdateCall struct { // Update: Updates a GTM Environment. // -// - path: GTM Environment's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/environments/{environment_i -// d}. +// - path: GTM Environment's API relative path. func (r *AccountsContainersEnvironmentsService) Update(path string, environment *Environment) *AccountsContainersEnvironmentsUpdateCall { c := &AccountsContainersEnvironmentsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -5665,8 +5454,7 @@ type AccountsContainersVersionHeadersLatestCall struct { // Latest: Gets the latest container version header // -// - parent: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM Container's API relative path. func (r *AccountsContainersVersionHeadersService) Latest(parent string) *AccountsContainersVersionHeadersLatestCall { c := &AccountsContainersVersionHeadersLatestCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5776,8 +5564,7 @@ type AccountsContainersVersionHeadersListCall struct { // List: Lists all Container Versions of a GTM Container. // -// - parent: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM Container's API relative path. func (r *AccountsContainersVersionHeadersService) List(parent string) *AccountsContainersVersionHeadersListCall { c := &AccountsContainersVersionHeadersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5921,8 +5708,7 @@ type AccountsContainersVersionsDeleteCall struct { // Delete: Deletes a Container Version. // -// - path: GTM ContainerVersion's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/versions/{version_id}. +// - path: GTM ContainerVersion's API relative path. func (r *AccountsContainersVersionsService) Delete(path string) *AccountsContainersVersionsDeleteCall { c := &AccountsContainersVersionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -5996,8 +5782,7 @@ type AccountsContainersVersionsGetCall struct { // Get: Gets a Container Version. // -// - path: GTM ContainerVersion's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/versions/{version_id}. +// - path: GTM ContainerVersion's API relative path. func (r *AccountsContainersVersionsService) Get(path string) *AccountsContainersVersionsGetCall { c := &AccountsContainersVersionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6115,8 +5900,7 @@ type AccountsContainersVersionsLiveCall struct { // Live: Gets the live (i.e. published) container version // -// - parent: GTM Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM Container's API relative path. func (r *AccountsContainersVersionsService) Live(parent string) *AccountsContainersVersionsLiveCall { c := &AccountsContainersVersionsLiveCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6225,8 +6009,7 @@ type AccountsContainersVersionsPublishCall struct { // Publish: Publishes a Container Version. // -// - path: GTM ContainerVersion's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/versions/{version_id}. +// - path: GTM ContainerVersion's API relative path. func (r *AccountsContainersVersionsService) Publish(path string) *AccountsContainersVersionsPublishCall { c := &AccountsContainersVersionsPublishCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6332,8 +6115,7 @@ type AccountsContainersVersionsSetLatestCall struct { // SetLatest: Sets the latest version used for synchronization of workspaces // when detecting conflicts and errors. // -// - path: GTM ContainerVersion's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/versions/{version_id}. +// - path: GTM ContainerVersion's API relative path. func (r *AccountsContainersVersionsService) SetLatest(path string) *AccountsContainersVersionsSetLatestCall { c := &AccountsContainersVersionsSetLatestCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6431,8 +6213,7 @@ type AccountsContainersVersionsUndeleteCall struct { // Undelete: Undeletes a Container Version. // -// - path: GTM ContainerVersion's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/versions/{version_id}. +// - path: GTM ContainerVersion's API relative path. func (r *AccountsContainersVersionsService) Undelete(path string) *AccountsContainersVersionsUndeleteCall { c := &AccountsContainersVersionsUndeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6531,8 +6312,7 @@ type AccountsContainersVersionsUpdateCall struct { // Update: Updates a Container Version. // -// - path: GTM ContainerVersion's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/versions/{version_id}. +// - path: GTM ContainerVersion's API relative path. func (r *AccountsContainersVersionsService) Update(path string, containerversion *ContainerVersion) *AccountsContainersVersionsUpdateCall { c := &AccountsContainersVersionsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6643,8 +6423,7 @@ type AccountsContainersWorkspacesCreateCall struct { // Create: Creates a Workspace. // -// - parent: GTM parent Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM parent Container's API relative path. func (r *AccountsContainersWorkspacesService) Create(parent string, workspace *Workspace) *AccountsContainersWorkspacesCreateCall { c := &AccountsContainersWorkspacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6749,8 +6528,7 @@ type AccountsContainersWorkspacesCreateVersionCall struct { // workspace, deletes the workspace, and sets the base container version to the // newly created version. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) CreateVersion(path string, createcontainerversionrequestversionoptions *CreateContainerVersionRequestVersionOptions) *AccountsContainersWorkspacesCreateVersionCall { c := &AccountsContainersWorkspacesCreateVersionCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6853,8 +6631,7 @@ type AccountsContainersWorkspacesDeleteCall struct { // Delete: Deletes a Workspace. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) Delete(path string) *AccountsContainersWorkspacesDeleteCall { c := &AccountsContainersWorkspacesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -6928,8 +6705,7 @@ type AccountsContainersWorkspacesGetCall struct { // Get: Gets a Workspace. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) Get(path string) *AccountsContainersWorkspacesGetCall { c := &AccountsContainersWorkspacesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -7038,8 +6814,7 @@ type AccountsContainersWorkspacesGetStatusCall struct { // GetStatus: Finds conflicting and modified entities in the workspace. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) GetStatus(path string) *AccountsContainersWorkspacesGetStatusCall { c := &AccountsContainersWorkspacesGetStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -7149,8 +6924,7 @@ type AccountsContainersWorkspacesListCall struct { // List: Lists all Workspaces that belong to a GTM Container. // -// - parent: GTM parent Container's API relative path. Example: -// accounts/{account_id}/containers/{container_id}. +// - parent: GTM parent Container's API relative path. func (r *AccountsContainersWorkspacesService) List(parent string) *AccountsContainersWorkspacesListCall { c := &AccountsContainersWorkspacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7288,8 +7062,7 @@ type AccountsContainersWorkspacesQuickPreviewCall struct { // QuickPreview: Quick previews a workspace by creating a fake container // version from all entities in the provided workspace. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) QuickPreview(path string) *AccountsContainersWorkspacesQuickPreviewCall { c := &AccountsContainersWorkspacesQuickPreviewCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -7389,8 +7162,7 @@ type AccountsContainersWorkspacesResolveConflictCall struct { // ResolveConflict: Resolves a merge conflict for a workspace entity by // updating it to the resolved entity passed in the request. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) ResolveConflict(path string, entity *Entity) *AccountsContainersWorkspacesResolveConflictCall { c := &AccountsContainersWorkspacesResolveConflictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -7478,8 +7250,7 @@ type AccountsContainersWorkspacesSyncCall struct { // unmodified workspace entities and displaying conflicts for modified // entities. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) Sync(path string) *AccountsContainersWorkspacesSyncCall { c := &AccountsContainersWorkspacesSyncCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -7578,8 +7349,7 @@ type AccountsContainersWorkspacesUpdateCall struct { // Update: Updates a Workspace. // -// - path: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - path: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesService) Update(path string, workspace *Workspace) *AccountsContainersWorkspacesUpdateCall { c := &AccountsContainersWorkspacesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -7688,8 +7458,7 @@ type AccountsContainersWorkspacesBuiltInVariablesCreateCall struct { // Create: Creates one or more GTM Built-In Variables. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesBuiltInVariablesService) Create(parent string) *AccountsContainersWorkspacesBuiltInVariablesCreateCall { c := &AccountsContainersWorkspacesBuiltInVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7911,9 +7680,7 @@ type AccountsContainersWorkspacesBuiltInVariablesDeleteCall struct { // Delete: Deletes one or more GTM Built-In Variables. // -// - path: GTM BuiltInVariable's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/b -// uilt_in_variables. +// - path: GTM BuiltInVariable's API relative path. func (r *AccountsContainersWorkspacesBuiltInVariablesService) Delete(path string) *AccountsContainersWorkspacesBuiltInVariablesDeleteCall { c := &AccountsContainersWorkspacesBuiltInVariablesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -8111,8 +7878,7 @@ type AccountsContainersWorkspacesBuiltInVariablesListCall struct { // List: Lists all the enabled Built-In Variables of a GTM Container. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesBuiltInVariablesService) List(parent string) *AccountsContainersWorkspacesBuiltInVariablesListCall { c := &AccountsContainersWorkspacesBuiltInVariablesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8249,9 +8015,7 @@ type AccountsContainersWorkspacesBuiltInVariablesRevertCall struct { // Revert: Reverts changes to a GTM Built-In Variables in a GTM Workspace. // -// - path: GTM BuiltInVariable's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/b -// uilt_in_variables. +// - path: GTM BuiltInVariable's API relative path. func (r *AccountsContainersWorkspacesBuiltInVariablesService) Revert(path string) *AccountsContainersWorkspacesBuiltInVariablesRevertCall { c := &AccountsContainersWorkspacesBuiltInVariablesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -8474,8 +8238,7 @@ type AccountsContainersWorkspacesClientsCreateCall struct { // Create: Creates a GTM Client. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesClientsService) Create(parent string, client *Client) *AccountsContainersWorkspacesClientsCreateCall { c := &AccountsContainersWorkspacesClientsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8577,9 +8340,7 @@ type AccountsContainersWorkspacesClientsDeleteCall struct { // Delete: Deletes a GTM Client. // -// - path: GTM Client's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/c -// lients/{client_id}. +// - path: GTM Client's API relative path. func (r *AccountsContainersWorkspacesClientsService) Delete(path string) *AccountsContainersWorkspacesClientsDeleteCall { c := &AccountsContainersWorkspacesClientsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -8653,9 +8414,7 @@ type AccountsContainersWorkspacesClientsGetCall struct { // Get: Gets a GTM Client. // -// - path: GTM Client's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/c -// lients/{client_id}. +// - path: GTM Client's API relative path. func (r *AccountsContainersWorkspacesClientsService) Get(path string) *AccountsContainersWorkspacesClientsGetCall { c := &AccountsContainersWorkspacesClientsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -8764,8 +8523,7 @@ type AccountsContainersWorkspacesClientsListCall struct { // List: Lists all GTM Clients of a GTM container workspace. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesClientsService) List(parent string) *AccountsContainersWorkspacesClientsListCall { c := &AccountsContainersWorkspacesClientsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8902,9 +8660,7 @@ type AccountsContainersWorkspacesClientsRevertCall struct { // Revert: Reverts changes to a GTM Client in a GTM Workspace. // -// - path: GTM Client's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/c -// lients/{client_id}. +// - path: GTM Client's API relative path. func (r *AccountsContainersWorkspacesClientsService) Revert(path string) *AccountsContainersWorkspacesClientsRevertCall { c := &AccountsContainersWorkspacesClientsRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9010,9 +8766,7 @@ type AccountsContainersWorkspacesClientsUpdateCall struct { // Update: Updates a GTM Client. // -// - path: GTM Client's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/c -// lients/{client_id}. +// - path: GTM Client's API relative path. func (r *AccountsContainersWorkspacesClientsService) Update(path string, client *Client) *AccountsContainersWorkspacesClientsUpdateCall { c := &AccountsContainersWorkspacesClientsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9122,8 +8876,7 @@ type AccountsContainersWorkspacesFoldersCreateCall struct { // Create: Creates a GTM Folder. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesFoldersService) Create(parent string, folder *Folder) *AccountsContainersWorkspacesFoldersCreateCall { c := &AccountsContainersWorkspacesFoldersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9225,9 +8978,7 @@ type AccountsContainersWorkspacesFoldersDeleteCall struct { // Delete: Deletes a GTM Folder. // -// - path: GTM Folder's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/f -// olders/{folder_id}. +// - path: GTM Folder's API relative path. func (r *AccountsContainersWorkspacesFoldersService) Delete(path string) *AccountsContainersWorkspacesFoldersDeleteCall { c := &AccountsContainersWorkspacesFoldersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9300,9 +9051,7 @@ type AccountsContainersWorkspacesFoldersEntitiesCall struct { // Entities: List all entities in a GTM Folder. // -// - path: GTM Folder's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/f -// olders/{folder_id}. +// - path: GTM Folder's API relative path. func (r *AccountsContainersWorkspacesFoldersService) Entities(path string) *AccountsContainersWorkspacesFoldersEntitiesCall { c := &AccountsContainersWorkspacesFoldersEntitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9428,9 +9177,7 @@ type AccountsContainersWorkspacesFoldersGetCall struct { // Get: Gets a GTM Folder. // -// - path: GTM Folder's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/f -// olders/{folder_id}. +// - path: GTM Folder's API relative path. func (r *AccountsContainersWorkspacesFoldersService) Get(path string) *AccountsContainersWorkspacesFoldersGetCall { c := &AccountsContainersWorkspacesFoldersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9539,8 +9286,7 @@ type AccountsContainersWorkspacesFoldersListCall struct { // List: Lists all GTM Folders of a Container. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesFoldersService) List(parent string) *AccountsContainersWorkspacesFoldersListCall { c := &AccountsContainersWorkspacesFoldersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9680,9 +9426,7 @@ type AccountsContainersWorkspacesFoldersMoveEntitiesToFolderCall struct { // request path equals 0, this will instead move entities out of the folder // they currently belong to. // -// - path: GTM Folder's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/f -// olders/{folder_id}. +// - path: GTM Folder's API relative path. func (r *AccountsContainersWorkspacesFoldersService) MoveEntitiesToFolder(path string, folder *Folder) *AccountsContainersWorkspacesFoldersMoveEntitiesToFolderCall { c := &AccountsContainersWorkspacesFoldersMoveEntitiesToFolderCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9781,9 +9525,7 @@ type AccountsContainersWorkspacesFoldersRevertCall struct { // Revert: Reverts changes to a GTM Folder in a GTM Workspace. // -// - path: GTM Folder's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/f -// olders/{folder_id}. +// - path: GTM Folder's API relative path. func (r *AccountsContainersWorkspacesFoldersService) Revert(path string) *AccountsContainersWorkspacesFoldersRevertCall { c := &AccountsContainersWorkspacesFoldersRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -9889,9 +9631,7 @@ type AccountsContainersWorkspacesFoldersUpdateCall struct { // Update: Updates a GTM Folder. // -// - path: GTM Folder's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/f -// olders/{folder_id}. +// - path: GTM Folder's API relative path. func (r *AccountsContainersWorkspacesFoldersService) Update(path string, folder *Folder) *AccountsContainersWorkspacesFoldersUpdateCall { c := &AccountsContainersWorkspacesFoldersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -10001,8 +9741,7 @@ type AccountsContainersWorkspacesGtagConfigCreateCall struct { // Create: Creates a Google tag config. // -// - parent: Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: Workspace's API relative path. func (r *AccountsContainersWorkspacesGtagConfigService) Create(parent string, gtagconfig *GtagConfig) *AccountsContainersWorkspacesGtagConfigCreateCall { c := &AccountsContainersWorkspacesGtagConfigCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10104,9 +9843,7 @@ type AccountsContainersWorkspacesGtagConfigDeleteCall struct { // Delete: Deletes a Google tag config. // -// - path: Google tag config's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/g -// tag_config/{gtag_config_id}. +// - path: Google tag config's API relative path. func (r *AccountsContainersWorkspacesGtagConfigService) Delete(path string) *AccountsContainersWorkspacesGtagConfigDeleteCall { c := &AccountsContainersWorkspacesGtagConfigDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -10180,9 +9917,7 @@ type AccountsContainersWorkspacesGtagConfigGetCall struct { // Get: Gets a Google tag config. // -// - path: Google tag config's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/g -// tag_config/{gtag_config_id}. +// - path: Google tag config's API relative path. func (r *AccountsContainersWorkspacesGtagConfigService) Get(path string) *AccountsContainersWorkspacesGtagConfigGetCall { c := &AccountsContainersWorkspacesGtagConfigGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -10291,8 +10026,7 @@ type AccountsContainersWorkspacesGtagConfigListCall struct { // List: Lists all Google tag configs in a Container. // -// - parent: Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: Workspace's API relative path. func (r *AccountsContainersWorkspacesGtagConfigService) List(parent string) *AccountsContainersWorkspacesGtagConfigListCall { c := &AccountsContainersWorkspacesGtagConfigListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10430,9 +10164,7 @@ type AccountsContainersWorkspacesGtagConfigUpdateCall struct { // Update: Updates a Google tag config. // -// - path: Google tag config's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/g -// tag_config/{gtag_config_id}. +// - path: Google tag config's API relative path. func (r *AccountsContainersWorkspacesGtagConfigService) Update(path string, gtagconfig *GtagConfig) *AccountsContainersWorkspacesGtagConfigUpdateCall { c := &AccountsContainersWorkspacesGtagConfigUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -10542,8 +10274,7 @@ type AccountsContainersWorkspacesTagsCreateCall struct { // Create: Creates a GTM Tag. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTagsService) Create(parent string, tag *Tag) *AccountsContainersWorkspacesTagsCreateCall { c := &AccountsContainersWorkspacesTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10645,9 +10376,7 @@ type AccountsContainersWorkspacesTagsDeleteCall struct { // Delete: Deletes a GTM Tag. // -// - path: GTM Tag's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ags/{tag_id}. +// - path: GTM Tag's API relative path. func (r *AccountsContainersWorkspacesTagsService) Delete(path string) *AccountsContainersWorkspacesTagsDeleteCall { c := &AccountsContainersWorkspacesTagsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -10721,9 +10450,7 @@ type AccountsContainersWorkspacesTagsGetCall struct { // Get: Gets a GTM Tag. // -// - path: GTM Tag's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ags/{tag_id}. +// - path: GTM Tag's API relative path. func (r *AccountsContainersWorkspacesTagsService) Get(path string) *AccountsContainersWorkspacesTagsGetCall { c := &AccountsContainersWorkspacesTagsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -10832,8 +10559,7 @@ type AccountsContainersWorkspacesTagsListCall struct { // List: Lists all GTM Tags of a Container. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTagsService) List(parent string) *AccountsContainersWorkspacesTagsListCall { c := &AccountsContainersWorkspacesTagsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10970,9 +10696,7 @@ type AccountsContainersWorkspacesTagsRevertCall struct { // Revert: Reverts changes to a GTM Tag in a GTM Workspace. // -// - path: GTM Tag's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ags/{tag_id}. +// - path: GTM Tag's API relative path. func (r *AccountsContainersWorkspacesTagsService) Revert(path string) *AccountsContainersWorkspacesTagsRevertCall { c := &AccountsContainersWorkspacesTagsRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -11078,9 +10802,7 @@ type AccountsContainersWorkspacesTagsUpdateCall struct { // Update: Updates a GTM Tag. // -// - path: GTM Tag's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ags/{tag_id}. +// - path: GTM Tag's API relative path. func (r *AccountsContainersWorkspacesTagsService) Update(path string, tag *Tag) *AccountsContainersWorkspacesTagsUpdateCall { c := &AccountsContainersWorkspacesTagsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -11190,8 +10912,7 @@ type AccountsContainersWorkspacesTemplatesCreateCall struct { // Create: Creates a GTM Custom Template. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTemplatesService) Create(parent string, customtemplate *CustomTemplate) *AccountsContainersWorkspacesTemplatesCreateCall { c := &AccountsContainersWorkspacesTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11293,9 +11014,7 @@ type AccountsContainersWorkspacesTemplatesDeleteCall struct { // Delete: Deletes a GTM Template. // -// - path: GTM Custom Template's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// emplates/{template_id}. +// - path: GTM Custom Template's API relative path. func (r *AccountsContainersWorkspacesTemplatesService) Delete(path string) *AccountsContainersWorkspacesTemplatesDeleteCall { c := &AccountsContainersWorkspacesTemplatesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -11369,9 +11088,7 @@ type AccountsContainersWorkspacesTemplatesGetCall struct { // Get: Gets a GTM Template. // -// - path: GTM Custom Template's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// emplates/{template_id}. +// - path: GTM Custom Template's API relative path. func (r *AccountsContainersWorkspacesTemplatesService) Get(path string) *AccountsContainersWorkspacesTemplatesGetCall { c := &AccountsContainersWorkspacesTemplatesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -11469,6 +11186,133 @@ func (c *AccountsContainersWorkspacesTemplatesGetCall) Do(opts ...googleapi.Call return ret, nil } +type AccountsContainersWorkspacesTemplatesImportFromGalleryCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ImportFromGallery: Imports a GTM Custom Template from Gallery. +// +// - parent: GTM Workspace's API relative path. +func (r *AccountsContainersWorkspacesTemplatesService) ImportFromGallery(parent string) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c := &AccountsContainersWorkspacesTemplatesImportFromGalleryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// AcknowledgePermissions sets the optional parameter "acknowledgePermissions": +// Must be set to true to allow Gallery template to be imported into the +// workspace. If this bit is false, the import operation will fail. +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) AcknowledgePermissions(acknowledgePermissions bool) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c.urlParams_.Set("acknowledgePermissions", fmt.Sprint(acknowledgePermissions)) + return c +} + +// GalleryOwner sets the optional parameter "galleryOwner": Owner of the +// Gallery template to import +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) GalleryOwner(galleryOwner string) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c.urlParams_.Set("galleryOwner", galleryOwner) + return c +} + +// GalleryRepository sets the optional parameter "galleryRepository": +// Repository of the Gallery template to import +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) GalleryRepository(galleryRepository string) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c.urlParams_.Set("galleryRepository", galleryRepository) + return c +} + +// GallerySha sets the optional parameter "gallerySha": SHA version of the +// Gallery template to import. Defaulted to the latest SHA version if not +// provided. +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) GallerySha(gallerySha string) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c.urlParams_.Set("gallerySha", gallerySha) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) Fields(s ...googleapi.Field) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) Context(ctx context.Context) *AccountsContainersWorkspacesTemplatesImportFromGalleryCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "tagmanager/v2/{+parent}/templates:import_from_gallery") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "tagmanager.accounts.containers.workspaces.templates.import_from_gallery", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "tagmanager.accounts.containers.workspaces.templates.import_from_gallery" call. +// Any non-2xx status code is an error. Response headers are in either +// *CustomTemplate.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountsContainersWorkspacesTemplatesImportFromGalleryCall) Do(opts ...googleapi.CallOption) (*CustomTemplate, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &CustomTemplate{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "tagmanager.accounts.containers.workspaces.templates.import_from_gallery", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type AccountsContainersWorkspacesTemplatesListCall struct { s *Service parent string @@ -11480,8 +11324,7 @@ type AccountsContainersWorkspacesTemplatesListCall struct { // List: Lists all GTM Templates of a GTM container workspace. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTemplatesService) List(parent string) *AccountsContainersWorkspacesTemplatesListCall { c := &AccountsContainersWorkspacesTemplatesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11618,9 +11461,7 @@ type AccountsContainersWorkspacesTemplatesRevertCall struct { // Revert: Reverts changes to a GTM Template in a GTM Workspace. // -// - path: GTM Custom Template's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// emplates/{template_id}. +// - path: GTM Custom Template's API relative path. func (r *AccountsContainersWorkspacesTemplatesService) Revert(path string) *AccountsContainersWorkspacesTemplatesRevertCall { c := &AccountsContainersWorkspacesTemplatesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -11726,9 +11567,7 @@ type AccountsContainersWorkspacesTemplatesUpdateCall struct { // Update: Updates a GTM Template. // -// - path: GTM Custom Template's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// emplates/{template_id}. +// - path: GTM Custom Template's API relative path. func (r *AccountsContainersWorkspacesTemplatesService) Update(path string, customtemplate *CustomTemplate) *AccountsContainersWorkspacesTemplatesUpdateCall { c := &AccountsContainersWorkspacesTemplatesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -11838,8 +11677,7 @@ type AccountsContainersWorkspacesTransformationsCreateCall struct { // Create: Creates a GTM Transformation. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTransformationsService) Create(parent string, transformation *Transformation) *AccountsContainersWorkspacesTransformationsCreateCall { c := &AccountsContainersWorkspacesTransformationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11941,9 +11779,7 @@ type AccountsContainersWorkspacesTransformationsDeleteCall struct { // Delete: Deletes a GTM Transformation. // -// - path: GTM Transformation's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ransformations/{transformation_id}. +// - path: GTM Transformation's API relative path. func (r *AccountsContainersWorkspacesTransformationsService) Delete(path string) *AccountsContainersWorkspacesTransformationsDeleteCall { c := &AccountsContainersWorkspacesTransformationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -12017,9 +11853,7 @@ type AccountsContainersWorkspacesTransformationsGetCall struct { // Get: Gets a GTM Transformation. // -// - path: GTM Transformation's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ransformations/{transformation_id}. +// - path: GTM Transformation's API relative path. func (r *AccountsContainersWorkspacesTransformationsService) Get(path string) *AccountsContainersWorkspacesTransformationsGetCall { c := &AccountsContainersWorkspacesTransformationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -12128,8 +11962,7 @@ type AccountsContainersWorkspacesTransformationsListCall struct { // List: Lists all GTM Transformations of a GTM container workspace. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTransformationsService) List(parent string) *AccountsContainersWorkspacesTransformationsListCall { c := &AccountsContainersWorkspacesTransformationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12266,9 +12099,7 @@ type AccountsContainersWorkspacesTransformationsRevertCall struct { // Revert: Reverts changes to a GTM Transformation in a GTM Workspace. // -// - path: GTM Transformation's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ransformations/{transformation_id}. +// - path: GTM Transformation's API relative path. func (r *AccountsContainersWorkspacesTransformationsService) Revert(path string) *AccountsContainersWorkspacesTransformationsRevertCall { c := &AccountsContainersWorkspacesTransformationsRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -12374,9 +12205,7 @@ type AccountsContainersWorkspacesTransformationsUpdateCall struct { // Update: Updates a GTM Transformation. // -// - path: GTM Transformation's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// ransformations/{transformation_id}. +// - path: GTM Transformation's API relative path. func (r *AccountsContainersWorkspacesTransformationsService) Update(path string, transformation *Transformation) *AccountsContainersWorkspacesTransformationsUpdateCall { c := &AccountsContainersWorkspacesTransformationsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -12486,8 +12315,7 @@ type AccountsContainersWorkspacesTriggersCreateCall struct { // Create: Creates a GTM Trigger. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTriggersService) Create(parent string, trigger *Trigger) *AccountsContainersWorkspacesTriggersCreateCall { c := &AccountsContainersWorkspacesTriggersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12589,9 +12417,7 @@ type AccountsContainersWorkspacesTriggersDeleteCall struct { // Delete: Deletes a GTM Trigger. // -// - path: GTM Trigger's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// riggers/{trigger_id}. +// - path: GTM Trigger's API relative path. func (r *AccountsContainersWorkspacesTriggersService) Delete(path string) *AccountsContainersWorkspacesTriggersDeleteCall { c := &AccountsContainersWorkspacesTriggersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -12665,9 +12491,7 @@ type AccountsContainersWorkspacesTriggersGetCall struct { // Get: Gets a GTM Trigger. // -// - path: GTM Trigger's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// riggers/{trigger_id}. +// - path: GTM Trigger's API relative path. func (r *AccountsContainersWorkspacesTriggersService) Get(path string) *AccountsContainersWorkspacesTriggersGetCall { c := &AccountsContainersWorkspacesTriggersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -12776,8 +12600,7 @@ type AccountsContainersWorkspacesTriggersListCall struct { // List: Lists all GTM Triggers of a Container. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesTriggersService) List(parent string) *AccountsContainersWorkspacesTriggersListCall { c := &AccountsContainersWorkspacesTriggersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12914,9 +12737,7 @@ type AccountsContainersWorkspacesTriggersRevertCall struct { // Revert: Reverts changes to a GTM Trigger in a GTM Workspace. // -// - path: GTM Trigger's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// riggers/{trigger_id}. +// - path: GTM Trigger's API relative path. func (r *AccountsContainersWorkspacesTriggersService) Revert(path string) *AccountsContainersWorkspacesTriggersRevertCall { c := &AccountsContainersWorkspacesTriggersRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13022,9 +12843,7 @@ type AccountsContainersWorkspacesTriggersUpdateCall struct { // Update: Updates a GTM Trigger. // -// - path: GTM Trigger's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/t -// riggers/{trigger_id}. +// - path: GTM Trigger's API relative path. func (r *AccountsContainersWorkspacesTriggersService) Update(path string, trigger *Trigger) *AccountsContainersWorkspacesTriggersUpdateCall { c := &AccountsContainersWorkspacesTriggersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13134,8 +12953,7 @@ type AccountsContainersWorkspacesVariablesCreateCall struct { // Create: Creates a GTM Variable. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesVariablesService) Create(parent string, variable *Variable) *AccountsContainersWorkspacesVariablesCreateCall { c := &AccountsContainersWorkspacesVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13237,9 +13055,7 @@ type AccountsContainersWorkspacesVariablesDeleteCall struct { // Delete: Deletes a GTM Variable. // -// - path: GTM Variable's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/v -// ariables/{variable_id}. +// - path: GTM Variable's API relative path. func (r *AccountsContainersWorkspacesVariablesService) Delete(path string) *AccountsContainersWorkspacesVariablesDeleteCall { c := &AccountsContainersWorkspacesVariablesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13313,9 +13129,7 @@ type AccountsContainersWorkspacesVariablesGetCall struct { // Get: Gets a GTM Variable. // -// - path: GTM Variable's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/v -// ariables/{variable_id}. +// - path: GTM Variable's API relative path. func (r *AccountsContainersWorkspacesVariablesService) Get(path string) *AccountsContainersWorkspacesVariablesGetCall { c := &AccountsContainersWorkspacesVariablesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13424,8 +13238,7 @@ type AccountsContainersWorkspacesVariablesListCall struct { // List: Lists all GTM Variables of a Container. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesVariablesService) List(parent string) *AccountsContainersWorkspacesVariablesListCall { c := &AccountsContainersWorkspacesVariablesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13562,9 +13375,7 @@ type AccountsContainersWorkspacesVariablesRevertCall struct { // Revert: Reverts changes to a GTM Variable in a GTM Workspace. // -// - path: GTM Variable's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/v -// ariables/{variable_id}. +// - path: GTM Variable's API relative path. func (r *AccountsContainersWorkspacesVariablesService) Revert(path string) *AccountsContainersWorkspacesVariablesRevertCall { c := &AccountsContainersWorkspacesVariablesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13670,9 +13481,7 @@ type AccountsContainersWorkspacesVariablesUpdateCall struct { // Update: Updates a GTM Variable. // -// - path: GTM Variable's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/v -// ariables/{variable_id}. +// - path: GTM Variable's API relative path. func (r *AccountsContainersWorkspacesVariablesService) Update(path string, variable *Variable) *AccountsContainersWorkspacesVariablesUpdateCall { c := &AccountsContainersWorkspacesVariablesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13782,8 +13591,7 @@ type AccountsContainersWorkspacesZonesCreateCall struct { // Create: Creates a GTM Zone. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesZonesService) Create(parent string, zone *Zone) *AccountsContainersWorkspacesZonesCreateCall { c := &AccountsContainersWorkspacesZonesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13885,9 +13693,7 @@ type AccountsContainersWorkspacesZonesDeleteCall struct { // Delete: Deletes a GTM Zone. // -// - path: GTM Zone's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/z -// ones/{zone_id}. +// - path: GTM Zone's API relative path. func (r *AccountsContainersWorkspacesZonesService) Delete(path string) *AccountsContainersWorkspacesZonesDeleteCall { c := &AccountsContainersWorkspacesZonesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -13961,9 +13767,7 @@ type AccountsContainersWorkspacesZonesGetCall struct { // Get: Gets a GTM Zone. // -// - path: GTM Zone's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/z -// ones/{zone_id}. +// - path: GTM Zone's API relative path. func (r *AccountsContainersWorkspacesZonesService) Get(path string) *AccountsContainersWorkspacesZonesGetCall { c := &AccountsContainersWorkspacesZonesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -14072,8 +13876,7 @@ type AccountsContainersWorkspacesZonesListCall struct { // List: Lists all GTM Zones of a GTM container workspace. // -// - parent: GTM Workspace's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. +// - parent: GTM Workspace's API relative path. func (r *AccountsContainersWorkspacesZonesService) List(parent string) *AccountsContainersWorkspacesZonesListCall { c := &AccountsContainersWorkspacesZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -14210,9 +14013,7 @@ type AccountsContainersWorkspacesZonesRevertCall struct { // Revert: Reverts changes to a GTM Zone in a GTM Workspace. // -// - path: GTM Zone's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/z -// ones/{zone_id}. +// - path: GTM Zone's API relative path. func (r *AccountsContainersWorkspacesZonesService) Revert(path string) *AccountsContainersWorkspacesZonesRevertCall { c := &AccountsContainersWorkspacesZonesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -14318,9 +14119,7 @@ type AccountsContainersWorkspacesZonesUpdateCall struct { // Update: Updates a GTM Zone. // -// - path: GTM Zone's API relative path. Example: -// accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/z -// ones/{zone_id}. +// - path: GTM Zone's API relative path. func (r *AccountsContainersWorkspacesZonesService) Update(path string, zone *Zone) *AccountsContainersWorkspacesZonesUpdateCall { c := &AccountsContainersWorkspacesZonesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -14430,7 +14229,7 @@ type AccountsUserPermissionsCreateCall struct { // Create: Creates a user's Account & Container access. // -// - parent: GTM Account's API relative path. Example: accounts/{account_id}. +// - parent: GTM Account's API relative path. func (r *AccountsUserPermissionsService) Create(parent string, userpermission *UserPermission) *AccountsUserPermissionsCreateCall { c := &AccountsUserPermissionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -14533,8 +14332,7 @@ type AccountsUserPermissionsDeleteCall struct { // Delete: Removes a user from the account, revoking access to it and all of // its containers. // -// - path: GTM UserPermission's API relative path. Example: -// accounts/{account_id}/user_permissions/{user_permission_id}. +// - path: GTM UserPermission's API relative path. func (r *AccountsUserPermissionsService) Delete(path string) *AccountsUserPermissionsDeleteCall { c := &AccountsUserPermissionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -14608,8 +14406,7 @@ type AccountsUserPermissionsGetCall struct { // Get: Gets a user's Account & Container access. // -// - path: GTM UserPermission's API relative path. Example: -// accounts/{account_id}/user_permissions/{user_permission_id}. +// - path: GTM UserPermission's API relative path. func (r *AccountsUserPermissionsService) Get(path string) *AccountsUserPermissionsGetCall { c := &AccountsUserPermissionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path @@ -14719,7 +14516,7 @@ type AccountsUserPermissionsListCall struct { // List: List all users that have access to the account along with Account and // Container user access granted to each of them. // -// - parent: GTM Account's API relative path. Example: accounts/{account_id}. +// - parent: GTM Account's API relative path. func (r *AccountsUserPermissionsService) List(parent string) *AccountsUserPermissionsListCall { c := &AccountsUserPermissionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -14857,8 +14654,7 @@ type AccountsUserPermissionsUpdateCall struct { // Update: Updates a user's Account & Container access. // -// - path: GTM UserPermission's API relative path. Example: -// accounts/{account_id}/user_permissions/{user_permission_id}. +// - path: GTM UserPermission's API relative path. func (r *AccountsUserPermissionsService) Update(path string, userpermission *UserPermission) *AccountsUserPermissionsUpdateCall { c := &AccountsUserPermissionsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.path = path diff --git a/tasks/v1/tasks-api.json b/tasks/v1/tasks-api.json index 01d2b390b9..f90fafbd65 100644 --- a/tasks/v1/tasks-api.json +++ b/tasks/v1/tasks-api.json @@ -17,7 +17,7 @@ "canonicalName": "Tasks", "description": "The Google Tasks API lets you manage your tasks and task lists.", "discoveryVersion": "v1", - "documentationLink": "https://developers.google.com/tasks/", + "documentationLink": "https://developers.google.com/workspace/tasks/", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -576,7 +576,7 @@ } } }, - "revision": "20250302", + "revision": "20250316", "rootUrl": "https://tasks.googleapis.com/", "schemas": { "AssignmentInfo": { @@ -689,7 +689,7 @@ "items": { "properties": { "description": { - "description": "The description. In HTML speak: Everything between \u003ca\u003e and \u003c/a\u003e.", + "description": "The description (might be empty).", "type": "string" }, "link": { @@ -697,7 +697,7 @@ "type": "string" }, "type": { - "description": "Type of the link, e.g. \"email\".", + "description": "Type of the link, e.g. \"email\", \"generic\", \"chat_message\", \"keep_note\".", "type": "string" } }, diff --git a/tasks/v1/tasks-gen.go b/tasks/v1/tasks-gen.go index 087fb6b16c..e2391b2564 100644 --- a/tasks/v1/tasks-gen.go +++ b/tasks/v1/tasks-gen.go @@ -6,7 +6,7 @@ // Package tasks provides access to the Google Tasks API. // -// For product documentation, see: https://developers.google.com/tasks/ +// For product documentation, see: https://developers.google.com/workspace/tasks/ // // # Library status // @@ -359,12 +359,12 @@ func (s Task) MarshalJSON() ([]byte, error) { } type TaskLinks struct { - // Description: The description. In HTML speak: Everything between and - // . + // Description: The description (might be empty). Description string `json:"description,omitempty"` // Link: The URL. Link string `json:"link,omitempty"` - // Type: Type of the link, e.g. "email". + // Type: Type of the link, e.g. "email", "generic", "chat_message", + // "keep_note". Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json index 066e1088fe..37dc6b6259 100644 --- a/tpu/v2alpha1/tpu-api.json +++ b/tpu/v2alpha1/tpu-api.json @@ -1021,7 +1021,7 @@ } } }, - "revision": "20250225", + "revision": "20250306", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2162,6 +2162,12 @@ "spot": { "description": "Optional. Defines whether the node is Spot VM.", "type": "boolean" + }, + "terminationTimestamp": { + "description": "Output only. The time at which the node will be terminated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" } }, "type": "object" diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go index c51b3a0ab4..f9030dd05f 100644 --- a/tpu/v2alpha1/tpu-gen.go +++ b/tpu/v2alpha1/tpu-gen.go @@ -1546,6 +1546,9 @@ type SchedulingConfig struct { Reserved bool `json:"reserved,omitempty"` // Spot: Optional. Defines whether the node is Spot VM. Spot bool `json:"spot,omitempty"` + // TerminationTimestamp: Output only. The time at which the node will be + // terminated. + TerminationTimestamp string `json:"terminationTimestamp,omitempty"` // ForceSendFields is a list of field names (e.g. "Preemptible") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/walletobjects/v1/walletobjects-api.json b/walletobjects/v1/walletobjects-api.json index a686938110..b2d8089355 100644 --- a/walletobjects/v1/walletobjects-api.json +++ b/walletobjects/v1/walletobjects-api.json @@ -2711,7 +2711,7 @@ } } }, - "revision": "20250303", + "revision": "20250312", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -6194,7 +6194,7 @@ "type": "object" }, "Image": { - "description": "Wrapping type for Google hosted images. Next ID: 8", + "description": "Wrapping type for Google hosted images.", "id": "Image", "properties": { "contentDescription": { diff --git a/walletobjects/v1/walletobjects-gen.go b/walletobjects/v1/walletobjects-gen.go index f413a899c5..4f315db336 100644 --- a/walletobjects/v1/walletobjects-gen.go +++ b/walletobjects/v1/walletobjects-gen.go @@ -4111,7 +4111,7 @@ func (s GroupingInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Image: Wrapping type for Google hosted images. Next ID: 8 +// Image: Wrapping type for Google hosted images. type Image struct { // ContentDescription: Description of the image used for accessibility. ContentDescription *LocalizedString `json:"contentDescription,omitempty"` diff --git a/workloadmanager/v1/workloadmanager-api.json b/workloadmanager/v1/workloadmanager-api.json index baed41ed7f..f0904be579 100644 --- a/workloadmanager/v1/workloadmanager-api.json +++ b/workloadmanager/v1/workloadmanager-api.json @@ -864,6 +864,25 @@ "location": "query", "type": "string" }, + "evaluationType": { + "description": "Optional. The evaluation type of the rules will be applied to. The Cloud Storage bucket name for custom rules.", + "enum": [ + "EVALUATION_TYPE_UNSPECIFIED", + "SAP", + "SQL_SERVER", + "OTHER", + "SCC_IAC" + ], + "enumDescriptions": [ + "Not specified", + "SAP best practices", + "SQL best practices", + "Customized best practices", + "SCC IaC (Infra as Code) best practices" + ], + "location": "query", + "type": "string" + }, "filter": { "description": "Filter based on primary_category, secondary_category", "location": "query", @@ -903,7 +922,7 @@ } } }, - "revision": "20250226", + "revision": "20250310", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "APILayerServer": { diff --git a/workloadmanager/v1/workloadmanager-gen.go b/workloadmanager/v1/workloadmanager-gen.go index 7f5b5e5c6e..dcb0d8e066 100644 --- a/workloadmanager/v1/workloadmanager-gen.go +++ b/workloadmanager/v1/workloadmanager-gen.go @@ -5563,6 +5563,22 @@ func (c *ProjectsLocationsRulesListCall) CustomRulesBucket(customRulesBucket str return c } +// EvaluationType sets the optional parameter "evaluationType": The evaluation +// type of the rules will be applied to. The Cloud Storage bucket name for +// custom rules. +// +// Possible values: +// +// "EVALUATION_TYPE_UNSPECIFIED" - Not specified +// "SAP" - SAP best practices +// "SQL_SERVER" - SQL best practices +// "OTHER" - Customized best practices +// "SCC_IAC" - SCC IaC (Infra as Code) best practices +func (c *ProjectsLocationsRulesListCall) EvaluationType(evaluationType string) *ProjectsLocationsRulesListCall { + c.urlParams_.Set("evaluationType", evaluationType) + return c +} + // Filter sets the optional parameter "filter": Filter based on // primary_category, secondary_category func (c *ProjectsLocationsRulesListCall) Filter(filter string) *ProjectsLocationsRulesListCall {